Importing products from Shopware 6 via our app

This guide will walk you through the steps to connect Shopware 6 to Channable and start importing your products seamlessly.

Table of contents

1. Download the app
2. Connect with Channable
3. Import your products from Shopware
   • Importing from a staging environment
4. Add another Shopware Connection

Step 1: Download the app

In order to connect Shopware 6 to Channable, you need to download the "Channable" app from the Shopware store. You can find the download here. The app can be installed in two ways: via the Shopware administration or Composer.

Installation via Shopware administration

1. Log in to your Shopware 6 administrator panel.
2. Navigate to Extensions > Store
3. Search for “Channable”, and select the "Channable Integration” app.
4. Click “Add extension”
5. Follow the steps in the installation wizard.
6. Navigate to Extensions > My extensions and click “Install” for the Channable app.

Installation via Composer

1. On store.shopware.com, search for the "Channable Integration" app.
2. Add the app to the cart and proceed to checkout.
3. Make sure to select your shop's domain on the checkout page.
4. Click "Complete payment" to finish setting up the license. Since the app is free to install, nothing will be charged.
5. Go to account.shopware.com and log in.
6. In the "Merchant" section of your account, navigate to "Shops" and select the correct shop
7. Scroll down to the "License list" and click on "Channable Integration"
8. Click on the "Install via Composer" button.

A pop-up opens with further instructions. Follow these to complete the installation.

Step 2: Connect with Channable

After installing the app in your Shopware backend, activate the app and navigate to Settings > Connect to Channable:

1. Press the Connect to Channable button. You will then be redirected to Channable.
   
2. In Channable, click on Add connection to create the connection with Shopware 6.
   
3. Once the connection is established, select a sales channel from the dropdown and click Save.
   

Step 3: Import your products from Shopware

Now that the connection with Shopware 6 has been successfully established, you can select the Shopware connection when adding an import to your project in Channable. Go to "Setup > Setup Import". Select the Shopware connection:

Ensure you select the correct language for your import from the dropdown under "Choose language" and click "Save". 

You will now be directed to the mapping. At the bottom, click on "Save & import" and your items will start importing from Shopware!

Importing from a staging environment

When creating a Shopware 6 connection through our app using a staging environment, it's necessary to whitelist our IP addresses to establish a connection. Without this, you may receive an error indicating that your credentials are incorrect, even though they are valid. To avoid this issue, please contact our support team to obtain the list of IP addresses that need to be whitelisted.

Add another Shopware Connection

To add a connection to another sales channel, you can simply start the process again at step 2: By clicking the "Connect to Channable" button again in your Shopware backend.

Troubleshooting

• Error: Connection with your eCommerce platform expired.
  To solve this error, you need to uninstall the Channable app from your Shopware backend:

  

  Then install the app again, follow this guide from step 2.  Make sure to finish this process within 24 hours after installing the app, to prevent the connection from expiring.
  
  

• Error: There is no sales channel selected in the Shopware connection.
  Go to Connections, where you can select the connection you want to use for the import. Click on “Edit”. Here, make sure to select a sales channel in the dropdown menu and click “Save”. You can now continue with step 3 and add a new import.
  
  
• The link field for my product contains an incorrect URL.
  We create these links by retrieving information from your Shopware backend. The domain for each URL is retrieved from the sales channel settings, so please ensure these settings are filled in correctly:
  
  
• I have a custom field that contains an image, but I only receive an ID instead of an image link.
  Retrieving the URL instead of the ID will put additional strain on your server, as we’re doing one additional request per product. Therefore, we only want to do this when it’s necessary. If you want us to activate the feature that turns these IDs into URLs, you can contact our support team.