Support Center

Connecting to CoreCommerce

Follow

 

CoreCommerce is available as a shopping cart system at Shopgate.

By setting up an API connection from your CoreCommerce shop to Shopgate, you will get these wonderful features straight into your mobile shop and apps:

 

Support

Version

 

All

Import to CoreCommerce

Orders

 

Customer Account

Login with Desktop Shop Account
Login to Desktop Shop with Mobile Account
Customer Groups / Tier Pricing
Show Desktop Orders On Mobile

 



✘ / ✘

Export to Shopgate Mobile Shop

Products
Categories
Reviews

 



Sync

Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity, on Product Detail Page

 



Validate, upon Cart Changes

Coupon
Shipping Method & Price
Product Availability

 



Payments Supported

Prepayment, Cash on Delivery, Credit Card, Direct Debit, Invoice, PayPal

Notes

N/A

 

In this article, you will find everything you need to set up a Shopgate mobile shop of your own.

 

Topics covered in this article:

  1. Creating an API user for Shopgate
  2. Establishing a connection to Shopgate
  3. Setting up mobile redirect
  4. Configuring the connection (optional)
  5. Frequently Asked Questions (FAQ)

 

Setting up a Shopgate connection to your CoreCommerce shop is simple and fast. All versions of CoreCommerce shops are supported and no installation needed! Now get started!

 

1. Creating an API user for Shopgate

The first step is to create an API user to connect with the Shopgate API technology. To do this, please follow the steps below:

  1. Log in to your CoreCommerce backend.



  2. Click on Settings. Then on the Settings page, click Store API.



  3. Create a Username, Password, and XML Key. Choose a good XML Key for a secure connection. Note down your Connection URL - you will need to enter this in the next chapter. Click Save.



  4. Now you have created an API user to connect to Shopgate.

 

2. Establishing a connection to Shopgate

To establish a connection between your CoreCommerce backend and your mobile shop, your need to enter your API credentials at Shopgate. Follow the steps below to make the connection:

  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 a system, type CoreCommerce and select it.



  4. A popup opens. Enter the API Connection URL, Username, Password, XML Key, and your Store Name from Chapter 1. Enter your shop URL. Click connect to establish the interface.



  5. If a connection is made successfully, a popup shown below will open. Leave all options to ON to access all features and click Save.



  6. Congratulations! Now you should see the progress bar running, and the Shopgate backend automatically filling your mobile shop with your products. Depending on how many products you have, the import process can take anywhere from a few minutes to a few hours. You can always check the status of the imports. If no status bar is shown, it means either the import is finished, or no import is running at the moment.

    Welcome to the mobile world :)



3. Setting up mobile redirect

To redirect mobile visitors to your mobile website, a few lines of code need to be modified in your main template file. Follow the steps below to do so.

  1. Log in to your Shopgate Admin page. Click on Integration from the menu bar, then select Credentials. Note down the Shop number.



  2. In your CoreCommerce backend navigate to Design > Google Analytics.



  3. Paste this JavaScript code (shown below) into the Google Analytics Code Field. If there is an existing Google Analytics Code, just paste this code above your Google Analytics Code.
    <!-- SHOPGATE MOBILE HEADER START -->
    <script type="text/javascript">
    var _shopgate = new Object();
    var shopgateCategory = document.getElementsByName("c")[0].value;
    var shopgateProduct = document.getElementsByName("productID")[0].value;

    _shopgate.shop_number = "YOUR SHOPGATE SHOP NUMBER";

    if (/\sg_debug=1$/.exec(document.URL) != null) {
    window.navigator = new Object({"userAgent":"RedirectBot"});
    }
    if (shopgateProduct != "") {
    _shopgate.redirect = "item";
    _shopgate.item_number = shopgateProduct;
    } else if (shopgateCategory != "") {
    _shopgate.redirect = "category";
    _shopgate.category_number = shopgateCategory;
    } else {
    _shopgate.redirect = "start";
    }

    _shopgate.host = (("https:" == document.location.protocol) ? "https://static-ssl.shopgate.com" : "http://static.shopgate.com");
    document.write(unescape("%3Cscript src='" + _shopgate.host + "/mobile_header/" + _shopgate.shop_number + ".js' type='text/javascript' %3E%3C/script%3E"));
    </script>
    <!-- SHOPGATE MOBILE HEADER END -->

  4. Replace YOUR SHOPGATE SHOP NUMBER with your shop’s number at Shopgate. Then click Save.



  5. That's it! Your mobile users have now been successfully redirected to your mobile shop.

 

4. Configuring the connection (optional)

You can configure the following in your Shopgate connection to your mobile shop:

  • Choose when to get order notifications
  • Choose to turn on/off Debug mode for developers
  • Choose to turn on Advanced error logging for developers

To configure the options, click on the Actions drop-down and select Edit.

Configure your connection in the settings page below. Detailed explanations for options listed can be found below.

When should the order be transmitted?

Orders can be transmitted right after they were placed or after they were paid.

Debug

This enables advanced debugging for your connection and is usually used by our developers only in case you’ve got a problem.

Advanced error logging

This will break all operations over your connection even on minor errors, making it easier to find the source of a problem if you have one for our developers.

API Connection URL

This is the Connection URL shown in your CoreCommerce's page in Chapter 1.

API Username

This is the username you created in your CoreCommerce's page in Chapter 1.

API Password

This is the password you created in your CoreCommerce's page in Chapter 1.

API XML Key

This is the XML Key you created in your CoreCommerce's page in Chapter 1.

API Store Name

This is the Store Name shown in your CoreCommerce's page in Chapter 1.

Shop Base URL

The base URL to your shop. For example: https://www.myawesomeshop.com

 

5. Frequently Asked Questions (FAQ)

5.1 How do I update my mobile shop?

You do not need to manually update your mobile shop. Whenever there is an update in the Shopgate software, we will update your shop via API method automatically.

 

Comments