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:

Go to Setup » 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 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:

Go to Setup » 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 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:

Go to Setup » Orders » Order referrer.
Activate the referrer Shopgate.
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:

Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.
Open the variation that you want to sell on Shopgate.
In the Availability area, activate the option Active.
Click on the Availability tab.
Click in the selection field in the Markets area.
→ A list of all available markets is displayed.
Activate the option Shopgate.
Activate the option Web API.
Click on Add ().
→ The market is added.
Save () the settings.
Go to Setup » Markets » Shopgate.
Select All items as the Export type.
Carry out additional settings as desired. Pay attention to the explanations given in Table 1.
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:

Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.
Click on the Availability tab.
In the SKU area, click on Add ().
→ The New SKU window 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 {referrer}. This price is displayed on {referrer}.

Defining a sales price for {referrer}:

Go to Setup » Item » Sales prices » Open sales price » Tab: Settings.
Activate the referrer {referrer}.
Save () the settings.

8. Linking properties

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

Linking properties:

Go to Setup » Item » Characteristics.
Expand the property ().
Activate 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 Setup » Orders » Payment » Methods.
Activate the option Also show inactive.
Open the folder International.
Click on Shopgate Payment.
→ The Settings tab opens.
Carry out the settings. Pay attention to the explanations 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 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

Go to Setup » Orders » Events.
Click on Add event procedure ().
→ The window Create new event procedure opens.
Enter a distinct name for the event procedure.
Select the event according to Table 4.
Save () the settings.
Carry out the settings according to Table 4 vor.
Place a check mark next to the option Active ().
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

Go to Setup » Orders » Events.
Click on Add event procedure ().
→ The window Create new event procedure opens.
Enter a distinct name for the event procedure.
Select the event according to Table 5.
Save () the settings.
Carry out the settings according to Table 5 vor.
Place a check mark next to the option Active ().
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