Skip to main content
  1. Home
  2. Markets and price search engines
  3. Shopgate

Shopgate

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 online store and which settings have to be made to connect the m-commerce market Shopgate to your plentymarkets system.

1. Registering with Shopgate

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

2. Setting up Shopgate in plentymarkets

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

Setting up Shopgate in plentymarkets:

  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 an online store.

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 online store.

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 plentymarkets 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 plentymarkets 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 online store 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 online store, e.g. http://mobile.yourplentystore.co.uk. Customers who access your online store 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 online store 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 online store 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] » Tab: Variation ID 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] » Tab: Variation ID » Tab: Settings.

  2. Open the variation that you want to sell on Shopgate.

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

  4. Click on the Availability tab.

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

  6. Activate the option Shopgate.

  7. Activate the option Web API.

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

  9. Save () the settings.

  10. Go to Setup » Markets » Shopgate.

  11. Select All items as the Export type.

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

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

Transferring selected items of a client

If you work with several online stores (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. Defining SKU manually

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

Adding SKU:

  1. Go to Item » Edit item » [Open item] » Tab: Variation ID » 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

Proceed as described below to define a sales price for the order referrer {referrer}. This price is displayed on {referrer}.

Defining a sales price for {referrer}:

  1. Go to Setup » Item » Sales prices » [Open sales price] » Tab: Settings.

  2. Activate the referrer {referrer}.

  3. 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. Activating the payment method

Activate the payment method Shopgate Payment as described below.

Activating the Shopgate payment method:

  1. Go to Setup » Orders » Payment » Methods.

  2. Activate the option Also show inactive.

  3. Open the folder International.

  4. Click on Shopgate Payment.
    → The Settings tab opens.

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

  6. Place a check mark next to the option Active.

  7. Save () the settings.

Table 3. Settings for the payment method
Setting Explanation

Language

The following options are saved for the language selected: Name, Info page, Info page (internal), Logo and Upload logo. This enables you to enter values for these options in various languages. The values for a language are activated as soon as a buyer selects the language in the online store.

Name

Enter the name that should be displayed in the online store and on invoices etc.

Info page

Select a category page of the type content or enter the URL of a website to provide information about the payment method.

Info page (external)

If you selected the Info page (external) option under Info page, then enter the URL of the info page here.

Countries of delivery

Do not select a country of delivery.
You cannot use the payment method in your online store. Therefore, this payment method is only activated in plentymarkets. It is not completely set up.

Logo

Select one of the following options for displaying the logo:

  • Show standard logo = The logo that is saved in plentymarkets for this payment method is displayed.

  • Do not show a logo = The logo that is saved in plentymarkets for this payment method is not displayed.

  • Show upload logo = The options Logo view and Upload logo are displayed.

Logo view

If Show upload logo was selected from the Logo drop-down list, then the logo that was uploaded is displayed here.

Upload logo

If Show upload logo was selected from the Logo drop-down list, then upload an external logo here.
Click on Upload files and select the logo that you want to upload for the payment method. Permitted data formats: GIF, PNG, and JPG.

Priority

Select the priority for displaying the payment method in the online store.

Costs: Flat rate or percentage

If the payment method results in additional costs, enter the percentage value or flat rate value. The selection depends on the conditions of your contract. Important: Do not enter a value into both fields.
For further information, refer to the Managing statistics page. For an example of flat rate and percentage costs, refer to the Managing payment methods page.
Permitting the payment method in customer classes

Go to Setup » CRM » Classes to activate or deactivate permitted payment methods.
For further information, refer to the Permitting the payment method in a customer class chapter.

For further information, refer to the Managing payment methods page.

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

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

  5. Save () the settings.

  6. Carry out the settings according to Table 4.

  7. Place a check mark next to the option Active ().

  8. Save () the settings.

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

Event

Order change: Status change > 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 5.

  5. Save () the settings.

  6. Carry out the settings according to Table 5.

  7. Place a check mark next to the option Active ().

  8. Save () the settings.

Table 5. 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
To top