Shopware

Shopgate supports Shopware as a shopping cart system.

By setting up the Shopgate plugin for your Shopware (version 4 and 5) shop, you will get these wonderful features straight into your mobile shop and apps:

☞ For instructions on an older version of Shopware, please read Connecting to Shopware 3.5
Supported Version Import to PrestaShop
Shopware 4 and 5   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
Shopgate, PayPal, PayPal Plus, Cash on Delivery, Prepayment, Invoice, Direct Debit, Billsafe, Sofort Überweising, Amazon Payments, Paymorrow (Invoice), Payolution

Up-sell products and DHL module supported.

Product and brand searches done in a search engine on a mobile device are now redirected to the shop's mobile website.

* Shopgate coupons will NOT work when the DHL module is used. Regular shop coupons are not affected and will continue to work on the desktop and the mobile sites.

** The payment validation feature allows you to offer specific payment options to targeted carts and customers. The availability of this feature depends on your PrestaShop settings.


In this article, you will find the instructions to set up the Shopgate plugin for your Shopware 4 and 5 shop.

 

Install Shopgate Extension

Installing the Shopgate extension for your Shopware shop is fast and easy!

  1. Simply go to this link and get the Shopgate extension by clicking Add to shopping cart. This extension is completely free for Shopgate users.
  2. Finish the checkout process. Log in with your Shopware ID and password, if you are not logged in yet.
  3. Install the extension by following the instructions.

That's it! Now the Shopgate extension has been installed in your Shopware shop.

If you would like to install the Shopgate extension using the zip file instead, here is how.

 

Establish connections

After the Shopgate plugin has been installed successfully, 2 simple tasks need to be done to connect your Shopgate mobile shop to your Shopware backend:

  • entering API credentials in your shop's backend, and
  • entering your shop's URL in your Shopgate's admin page.

Get API credentials

  1. Log in to your Shopgate Admin page.
  2. Click on Integration from the menu bar, then select Install Interface.
  3. In the drop-down labeled Select system, search for Shopware 4.x and select it.
  4. A popup opens. Look for Customer number, Shop number, API key, and Alias under 2. Configure. These are the API credentials the plugin needs to authenticate at the Shopgate backend. Leave this page open - we will come back to enter the URL (explained in Establish connections)

  5. Copy Customer number, Shop number, API key, and Alias, and paste them individually onto the plugin configuration page in your Shopware Admin (Configuration -> Plugin Manager -> Shopgate Extension Settings). The rest of the options can be configured later. This is explained in Chapter 4. Configuring the Plugin). Click Save plugin settings.

    shopware_screenshot_en.png

 

Connect your shop to Shopgate

  1. Go back to the pop-up window at your Shopgate merchant page (step 4).
  2. Under "3. Enter URL", enter the URL of your shop, ideally starting with “https://”. For example https://www.MyAwesomeShop.com. Click connect to establish the interface.
  3. If a connection is made successfully, a popup shown below will open. Here you will be able to assign jobs to your first connection. We recommend leaving all assignments to ON at this time. Click Save.

That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface. And welcome to the mobile world 😊

 

Update an existing plugin

Before updating your Shopgate plugin to a newer version, make sure to check if your shop uses a customized version of the Shopgate plugin. If this is the case, a generic plugin update will NOT work for your shop.

You are using a customized version if:

  • you have contacted Shopgate for making a 3rd party plugin to work in your mobile shop, or adding a special feature/function
  • Shopgate has sent you an adapted version of plugin
  • the plugin file you installed has "adaption" in the name

Once you know if you are using a customized Shopgate plugin or not, follow the instructions below to update it:

Generic Plugin Customized Plugin
  1. Download the latest plugin and upload it to your Shopware Admin.
  2. After a newer version of the plugin is successfully uploaded, a new button will appear in the Action(s) section. Click on it to update the plugin automatically.
  3. If no update button appears, save your current Shopgate plugin configurations somewhere else, and click on the Reinstall plugin button. Afterwards, you need to configure the plugin again with the data you saved before the reinstall.

 

Configure the Plugin

In the configuration panel of your Shopware Admin (Configuration -> Plugin Manager -> Shopgate Extension Settings), you are able to configure the plugin further.

shopware_screenshot_en.png

Setting Options Explained
Active Select Yes to activate the Shopgate plugin for your shop.
Customer number This is your Shopgate Customer number. See Chapter 2.1 for more information.
Shop number This is your Shopgate Shop number. See Chapter 2.1 for more information.
API key This is your Shopgate API Key. See Chapter 2.1 for more information.
Shop alias This is your Shopgate Alias. See Chapter 2.1 for more information.
CNAME A CNAME is a subdomain of your own domain that points to your mobile website. For example, a CNAME could look like "m.myshop.com". To configure a CNAME, please log on to your server hosting website. For more information, please read our help article Adding a CNAME record in your domain host
Root Category Choose the root category of your shop.
Redirect Type HTTP redirect is recommended for better performance and search engine rankings. However, using external cache engines (e.g. Varnish) might cause problems such as a "redirect loop". In that case, use JavaScript redirect instead.
Redirect Homepage is Blog If checked, it is redirected if your homepage is a blog.
Order state if shipping is not blocked Set order status to Offen if shipping is not blocked.
Shipping method for incoming orders Select a fixed shipping method for Shopgate orders. Will be used in case the imported order shipping method cannot be mapped.
Send order confirmation mail to customer Allow Shopware to send an email notification for each new order imported from Shopgate
Products description layout Choose the field for the product description for the product export.
Products downloads export Choose here how to export downloads of products.
Einheit für Produktmaße Choose here which unit you want to use for product measures.
Attribute ids for product export All attribute ids will be exported in the property section of the product, format e. g. 3 for attr3
Artikel-Eingabefelder an Beschreibung anhängen Choose a list of attributes which additionally is attached to the description.
Shopgate server Do not change this setting unless instructed by your Shopgate support personnel.
API URL Do not change this setting unless instructed by your Shopgate support personnel.

 

Frequently Asked Questions

Why is "generic payment" displayed instead of SOFORT Überweisung/Paypal/Credit card?

This is because payment methods that could not be automatically assigned from the Shopgate plugin will be listed as "Generic Payment".

 

Why couldn't my orders transfer from Shopware to plentyMarkets ERP system?

If you use plentyMarkets ERP (Enterprise Resource Planning) system in your Shopware Shopping Cart System, it is a known issue that Shopgate orders may not be transferred correctly.

To fix it, please make the following changes to the "plentyMarket Connector Module" in your Shopware settings:

  1. Navigate to Settings ->plentyMarkets.
  2. In plentymarket's configuration page, click Settings tab.
  3. Look for "Shopgate Zahlungsart(en)" under section"Export Aufträge".
  4. In the text field, select "Generische Zahlungsart von Shopgate - Greift, wenn keine passende Zahlungsart gefunden wurde" and "Shopgate Zahlungsart - Der Zahlungsfluss läuft über das Shopgate-Konto".

 

Why did an order failed to transfer?

This may be caused by the DHL module.

If you use the DHL module in your Shopware backend, an error might occur when a customer uses mobile coupons*. Desktop coupons created via your Shopware backend, however, should not cause this issue.

* Coupons created for the mobile website and/or apps in your Shopgate Admin.

 

How to install the Shopgate extension using the zip file?

You can also install the Shopgate extension for Shopware by downloading the zip file called shopgate-shopware-integration.zip via this link then uploading it to your Shopware shop backend:

  1. Log in to your Shopware admin and navigate to Configuration -> Plugin Manager.
  2. On your Plugin Manager page, select "+ Add plugin manually". A new window will appear. Click Select plugin, select the zip file you just downloaded, and click "Upload plugin" button.
  3. After the Shopgate plugin has been successfully uploaded, the Shopgate plugin should be listed in the Plugin Manager as inactive. To activate the plugin, click the green "+" button on the right.
  4. A configuration section will open. Check the box "Activate plugin" to activate the Shopgate Plugin.

That's it! Now you have installed the Shopgate plugin for your Shopware shop using the zip file. 

 

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