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 have to be taken 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 access data from Shopgate.

2. Setting up Shopgate in plentymarkets

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

Setting up Shopgate in plentymarkets:

Go to System » System settings » Markets » Shopgate.
Expand the client (store).
Carry out the settings. Pay attention to the explanations given in table 1.
Save the settings.

Table 1. Settings for the market Shopgate
Setting	Explanation
Access data
Operating mode	Select the 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	NO = Interface is inactive. YES = Interface is active.
Export type	Select Client (store) item or All items. All items = Exports all items. Client (store) item = Only exports those items that were made available for an online store.
Item name	Select the name that should be used for Shopgate.
Language	Select the language that should be used for Shopgate.
Item discount coupons active	Select whether coupon codes should be checked and accepted for campaigns with the discount type Item discount. Yes = Coupon codes are checked and the discount is deducted 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 represents the stock that is displayed on Shopgate. Important: Item variations are only transmitted if the Limitation option is either set to No limitation or Limited to net stock in the item’s Stock tab.
Maximum for item upload	Enter the maximum amount of items that you want to upload to Shopgate.
Item description	If you select a free text field, then the text saved for 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 are not 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 against 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, 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:

Go to System » System settings » Client » Select client » Online store » Forwarding.
Carry out the settings. Pay attention to the explanations given in table 2.
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 the specified 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. The URL would then look like this: http://mobile.yourplentystore.co.uk/?itemNumber=$itemId&referrerId=$referrerId Note: If you do not enter a URL here, then customers will not be forwarded to the items in your online store from price comparison portals etc.

4. Activating an order referrer

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

Activating the order referrer for Shopgate:

Go to System » System settings » Orders » Order referrer.
Place a check mark next to Shopgate.
Save the settings.

5. Setting the item availability

Items have to be available for Shopgate. This is done in the Availability tab of an item within the Item » Edit item » Tab: Variation ID menu. In addition, you can select whether all items or only selected items should be transferred. This can be done in the menu System » System settings » Markets » Shopgate.

Setting the item availability for Shopgate:

Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.
Activate the main variation in the Availability section.
Click on the Availability tab.
Click in the selection field in the Markets section.
→ A list with all available markets is displayed.
Place a check mark next to the option Shopgate.
Place a check mark next to the option Web API.
Click on Add.
→ The market is added.
Save the settings.
Go to System » System settings » Markets » Shopgate.
Select All items as the Export type.
Carry out the optional settings as desired. Pay attention to the explanations given in table 1.
Save the settings.
→ The item is available on Shopgate.

The availability for variations can be individually edited in the Item » Edit item » Open item » Tab: Variations » Open variation » Tab: Variation ID » Tab: Availability menu.

Transferring selected items of a client

If you work with several online stores (clients) and you do not 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 menu System » System settings » Markets » Shopgate.
Activate at least one client under Markets in the item’s Availability tab.
It is not permitted to select all or none of the stores. 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 for specific referrers in the menu Item » Edit item » Open item » Tab: Variation ID.

Adding SKU:

Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.
Click on the Availability tab.
Click on Add in the section SKU.
→ The window New SKU is displayed.
Select the referrer Shopgate.
Select the corresponding marketplace account.
Enter the SKU.
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 Shopgate. This price is displayed on Shopgate.

Defining a sales price for Shopgate:

Open the menu System » System settings » Item » Sales prices » Open sales price » Tab: Settings.
Place a check mark next to the referrer Shopgate.
Save the settings.

8. Linking properties

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

Linking properties:

Go to System » System settings » Item » Properties.
Expand a property.
Place a check mark next to the option Shopgate.
Save the settings.

9. Activating the payment method

Activate the payment method Shopgate Payment as described below.

Activating the Shopgate payment method:

Go to System » System settings » Orders » Payment » Methods.
Place a check mark next to the setting Also show inactive.
Open the folder International.
Click on Shopgate Payment.
→ The Settings tab opens.
Carry out the settings. Pay attention to the information given in table 3.
Place a check mark next to the option Active.
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 makes it possible 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 have selected the option Info page (external) 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 has been selected from the Logo drop-down list, then the logo that has been uploaded is displayed here.
Upload logo	If Show upload logo has been selected from the Logo drop-down list, 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 choice depends on the conditions of your contract. Important: Do not enter a value into both fields. For further information, refer to the Statistics page of the manual. For an example of flat rate and percentage costs, refer to the Managing payment methods page of the manual.

Permitting the payment method in customer classes

Go to System » System settings » CRM » Classes to activate or deactivate Permitted payment methods.
For further information, refer to the Permitting the payment method in a customer class chapter of the manual.

For further information, refer to the Payment methods page of the manual.

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 the invoice so that you do not have to send an invoice to the customer. You can check this in your Shopgate orders or create an event procedure to automate this.

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

Go to System » System settings » Orders » Events.
Click on Add event procedure.
→ The Create new event procedure window opens.
Enter a name.
Select the event listed in Table 4.
Save the settings.
→ The event is created.
Carry out further settings. Pay attention to the explanations given in Table 4.
Place a check mark next to the option Active.
Save the settings.
→ The event procedure is saved.

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

Go to System » System settings » Orders » Events.
Click on Add event procedure.
→ The Create new event procedure window opens.
Enter a name.
Select the event listed in Table 5.
Save the settings.
→ The event is created.
Carry out further settings. Pay attention to the explanations given in Table 5.
Place a check mark next to the option Active.
Save the settings.
→ The event procedure is saved.

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