Support Center

Connecting to xt:Commerce 4/5 (VEYTON)

Follow

 

xt:Commerce is available as a shopping cart system at Shopgate.

By setting up the Shopgate plugin for your xt:Commerce VEYTON shop, you will get these wonderful features straight into your mobile shop and apps:

 

Supported Version Import to xt:Commerce

4.0.12 +, 5.0.00 +

  Orders
Sync Export to Shopgate Mobile Shop

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



Products
Categories
Reviews



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

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

N/A

 

In this article, you will find everything you need to set up the Shopgate plugin for your xt:Commerce VEYTON shop.

 

Topics covered in this article:

  1. Installing the Shopgate Plugin
  2. Establishing connection between plugin and Shopgate
  3. Updating an existing Shopgate plugin
  4. Configuring the Plugin
  5. Frequently Asked Questions (FAQ)

 

1. Installing the Shopgate plugin

The Shopgate plugin for xt:Commerce VEYTON can be installed in all xt:Commerce shop starting from version 4.0.12. Simply upload the plugin to your xt:Commerce VEYTON folder and activate it in your xt:Commerce VEYTON admin page. To do this, please follow the steps below:

1.1 Downloading the plugin

Download the plugin here: http://files.shopgate.com/plugins/veyton.zip and extract the contents of the zip file.

1.2 Uploading the plugin

You need an FTP client tool to copy the plugin into your xt:Commerce VEYTON shop's root directory. Plenty of FTP programs can be found on the internet. If you don’t know which one to use, we recommend FileZilla. (Link to download FileZilla)

  1. Connect FileZilla or another FTP program to your server.
  2. Navigate to the Shopgate plugin you just extracted from the previous step. Drag the entire folder xt_shopgate to a subfolder called plugins in your shop. When asked, choose to overwrite files and folders.



1.3 Setting permissions

Set permissions for the folders config and temp that are located in /includes/external/shopgate/shopgate_library to readable and writeable (664*). Set the options exactly as it is shown below. Click OK.

* If you cannot save your changes or configurations, set file permissions to 777.

 

1.4 Installing the plugin

  1. Log into your shop’s backend.

  2. Navigate to Plugins > plugins uninstalled in the menu to the left. Look for the Shopgate Mobile Shopping plugin under "modul class: mobile". Click the green icon to the right to install the Shopgate plugin.



  3. If installed correctly, the following screen will be displayed. Click close window to close this dialog.



  4. Now go back to plugins installed tab and locate the Shopgate plugin under "modul class: mobile". If you don't see the Shopgate plugin, refresh the page.



  5. The plugin status will show as (inactive). Click on the edit button to open the configuration page (shown below) for the Shopgate plugin. Leave this page open - we will explain how to find the required info in the next chapters.

 

2. Establishing connections between the plugin and Shopgate

After the Shopgate plugin has been installed successfully, two simple tasks need to be done to connect your mobile shop at Shopgate to your shop's backend: to enter API credentials in your shop's backend, and to enter your shop's URL in your Shopgate's admin page.

2.1 Getting 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 a system, type veyton and select xt:Commerce VEYTON (VEYTON).



  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 2.2 Establishing connection)



  5. Copy Customer number, Shop number, API key, and Alias, and paste them individually onto the plugin configuration page you left open from the last chapter. Check the box for plugin status, and set Enable to yes. The rest of the options can be configured later (Explained in Chapter 4. Configuring the Plugin). Click Save.

 

2.2 Connecting your shop to Shopgate

  1. Go back to the pop-up window at your Shopgate merchant page (step 4). Enter your shop's URL to the text field under 3. Enter URL. Click connect to establish the interface.



  2. If a connection is made successfully, a popup shown below will open. Here you will be able to assign jobs for your first connection. We recommend to leave all assignments to ON at this time. Click Save.



  3. 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. Updating an existing Shopgate plugin

To update your Shopgate plugin to a newer version, you need to uninstall the current version of the plugin and install the new version.

  1. Log into your shop’s backend. Navigate to Plugin > plugins installed in the menu to the left. Look for the Shopgate Mobile Shopping plugin under "modul class: mobile". Click the red icon to the right to uninstall the Shopgate plugin.



  2. Then refer to Chapter 1 to learn how to install the latest version of the plugin.

 

4. Configuring the plugin

Find the detailed explanations under each option. Refer to Chapter 1.4.5 to learn where to find the configuration page.

4.1 default

Set the plugin status to be checked when using the Shopgate plugin, and leave the rest as is.

 

4.2 Main Store

Custom URL to mobile webpage (CNAME) A CNAME is a subdomain of your own domain that points to your mobile website. Usually, that’s something like m.myawesomeshop.com. You’ll have to configure this on your server.
Shopgate server Choose between the “Live” or the “Playground” Shopgate servers for API communication. Alternatively, you can provide a “Custom” Shopgate API URL.
Custom Shopgate server URL If you chose “Custom” in the drop-down menu box above, provide a custom URL to the Shopgate API here.
Products description Choose between the short description, the long description or a combination of both to be used for exporting your products to Shopgate.
Order status - ready for delivery Set the status to be assigned on incoming Shopgate orders that are not blocked for shipping.
Order status - shipping blocked Set the status to be assigned on incoming Shopgate orders that are blocked for shipping.
Order status - canceled Select the status you set on orders that have been canceled. This is used to synchronize the cancellation status of orders with Shopgate.
Order status - shipped Select the status you set on orders that have been shipped. This is used to synchronize the shipping status of orders with Shopgate.
Default user group for special pricing Choose the user group products will be exported for to Shopgate. This mainly regards the pricing of your products.
Send Shopgate order confirmation mail Choose yes to have a mail sent to the customer after an incoming Shopgate order has successfully been imported.

 

5. Frequently Asked Questions (FAQ)

5.1 My Veyton Shop uses an Enterprise Resource Planning (ERP) System. Would that be a problem?

When an external Enterprise Resource Planning System (e.g. Pixi) is used, it's possible that incoming orders may not sync properly. If you notice that orders you marked as "shipped" are not marked the same in your Shopgate backend, please contact your support team. This may be resolved easily.

 

5.2 My Veyton Shop uses 3rd party plugins. Will this cause any issues?

If you are extending you shopping cart system with other plugins, it's possible that you will encounter issues for exporting products and importing orders. For issues caused by 3rd party plugins, special adaptions from the Shopgate Interface Development may be necessary (at a cost).

 

5.3 Which plugins are supported at Shopgate?

At the moment, Shopgate supports the following Veyton plugins: "Options- und Freitext"-Plugin starting from version 2.4.0 with friendly support from Business und Internetagentur Hinsche GmbH.

 

5.4 Incorrect information is displayed in my Veyton backend. What should I do?

If you use a Veyton version older than v2.4.0, it's possible that orders are not transferred correctly to your shop system. This is due to Veyton's database modifications.

For example:

Solution:

Please check the table xt_orders_status_history, where you should see the following columns:

  • orders_status_history_id
  • orders_id
  • orders_status_id
  • customer_notified
  • comments
  • change_trigger
  • callback_id
  • customer_show_comment

The column "customer_show_comment" is only available in a newer version but is important to make sure every order will be imported to your Shop backend.

 

5.5 Why doesn't my mobile redirect work?

Please check the following configurations of your Shopgate plugin:

  • Plugin Status needs to be selected (see 3 in the screenshot).
  • Enable needs to be true (see 4 in the screenshot).

☞ Please note, that the option Enable mobile website and Mobile shop has been activated by Shopgate is not visible anymore. 

 

5.6 All settings are configured as described but the plugin still doesn't work. What should I do?

Use a Veyton version before 4.0.14? If this is the case, an extension called Hookpoint needs to be applied to your shop system. This extension was only introduced in version 4.0.14. However, if you wish, our technical team can make this adjustment for your at your own risk. We simply need to access the file system of your online shop, for example, via FTP.

 

5.7 An error appears at the Shopgate settings "requires the ionCube PHP Loader"

To correct this error, copy the file php.ini from your shop backend to folder plugins/xt_shopgate/pages.

Comments