Magento 2

Magento 2 is a supported shopping cart system at Shopgate.

By setting up Shopgate plugin in your Magento 2 shop, you will get these useful features straight into your app and mobile website:

Support		Import to Magento 2
Version	2.1+	Orders	✔
Customer Account		Export to Shopgate Mobile Shop
Login with Desktop Shop Account Login to Desktop Shop with Mobile Account Customer Groups/Tier Pricing Show Desktop Orders on Mobile	✔ ✔ ✔ / ✔ ✘	Products Categories Reviews	✔ ✔ ✔
Sync		Validate, upon Cart Changes
Delivery Status "Shipped" Order Status "Canceled" Stock Quantity on Product Detail Page	✘ ✘ ✔	Coupon* Shipping Method Payment Method Product Availability	✔ ✔ ✘ ✔
Supported Payments		Notes
Prepayment Invoice Cash on Delivery Braintree PayPal Braintree Creditcard		Other supported features: Info from the Shopgate custom fields (second phone number, birthdays, etc.) is now imported as order details in your Magento 2 backend. Group, configurable, and simple products Group pricing for simple and configurable products * Only coupons created in your Magento backend will work. Shopgate coupons do NOT work. To create app-exclusive coupons, click here. Please note that the features "Special Offers" and "Liveshopping" are currently not supported in combination with Magento 2.

In this article, you will find everything you need to set up the Shopgate plugin for your Magento 2 shop.

Install the Shopgate plugin

Before you install or update the Shopgate plugin
	✓ disable Magento cache if enabled ✓ disable all external caching (e.g. Varnish, APC, ZendCache) if used
After you install or update the Shopgate plugin
	✓ enable Magento cache again ✓ flush the internal cache and all external cache immediately

Download the Shopgate plugin

Download the Shopgate extension for Magento 2 from the Magento Marketplace.
Follow these instructions to install the Shopgate extension in your Magento system.

Alternatively, you can use the command line and composer to install the extension. Our component name is "shopgate/cart-integration-magento2-m2". For more information on this method, review Magento's Composer Installation Guide.

Connect the plugin to Shopgate

After the Shopgate plugin has been installed, follow the steps here to connect your mobile shop to your Magento 2 backend.

Log in to your Shopgate Admin.
Navigate to Integration, then Install Interface.
In the New Connection section, search for "Magento 2" in the drop-down and select it when it appears.
A pop-up will open.

Get API credentials

In the pop-up, copy Customer number, Shop number, API key, and Alias and paste them individually into the plugin configurations in your Magento 2 admin panel: Stores > Settings > Configuration.

The rest of the plugin configurations can be entered later, with instructions listed later in this article.

Connect your shop to Shopgate

Under 2. Enter URL, enter the URL of your shop. Click Connect to establish the interface.

If a connection is made successfully, the popup shown below will open. Leave all assignments to ON to access all the features. Click Save.

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

Understand the plugin configurations

To locate the Shopgate configuration, follow the steps here:

Log into your Magento 2 Admin Panel.
Navigate to Stores > Settings > Configuration.
You will see Shopgate listed on the configuration page.
Use these sections to configure your Shopgate plugin: Configuration, Export, Import, and Advanced.

Shopgate | Configuration

Basic Configuration
Enabled	Select Yes to activate the Shopgate plugin in your Magento 2 backend.
Customer number	Your customer number at Shopgate.
Shop number	Your shop number at Shopgate.
API Key	Your API Key generated at Shopgate. This key is used to authenticate your account between Shopgate and Magento.
Mobile Settings
Redirect Type	Select your redirect type: HTTP or JavaScript. HTTP is recommended because it is more SEO friendly.
Website alias	Your Shopgate alias.
Custom URL	A URL used for the mobile version of your shop. The default is [alias].shopgate.com, but an alternate could be m.[alias].com
CMS Map	This feature allows mapping a Magento 2 CMS page to a CMS page created in your Shopgate Admin. Provide the URL key used by the CMS page in Shopgate.

Shopgate | Export

Categories
Force export disabled categories	List a comma separated list of category IDs (e.g. 1,4,6,34) which should be exported even if they are disabled.
In navigation only	Export categories that only have "Include In Navigation" checked.
Products
Description	Choose how you want to export your descriptions: Short description Description + short description Short description + description.
EAN attribute	Select the attribute used for the EAN from the list.
Miscellaneous
Net Market Countries	Use the default value from Magento 2 or select the countries where your product prices are defined before tax (e.g. United States).

Shopgate | Import

Order
Send an email to customer on new order	On each order import, the customer will get an order confirmation mail after the import. This flag should be used in conjunction with the "send confirmation mail" flag in the Shopgate merchant area.
Shopgate Shipping Carrier Title	This text field allows the merchant to define a shipping title for any shipping handled by Shopgate. This shipping title is used in emails and order details.

Shopgate | Advanced

Staging
Shopgate server	Select the Shopgate Live server. Use the other options only for debugging purposes.
Shopgate Merchant API URL	This field is used only when Shopgate server is set to “custom” and is only useful for debugging purposes.
.htaccess user	.htaccess user and password are only used to bypass additional htaccess authentications.
.htaccess password

Frequently Asked Questions

How do I flush or disable the Magento cache?

If you need to flush or disable the Magento cache in order to install or update a Shopgate plugin, follow the steps here. Remember to enable the Configuration cache again after the plugin is installed or updated.

Go to System > Tools > Cache Management.
Click Flush Magento Cache to clear the Magento cache.
To temporarily disable the Magento cache, select Configuration, set Action to Disable, then click Submit.

Now the Magento cache has been flushed and disabled.

eCommerce Platform (ECP)