Quick Start Guide

Get Channable Connect up and running in minutes. This guide walks you through the essential setup steps to connect your Magento store with Channable and start selling on marketplaces.

Step 1: Install the Extension

Via Composer (recommended)

composer require magmodules/magento2-channable
bin/magento module:enable Magmodules_Channable
bin/magento setup:upgrade
bin/magento cache:flush

Verify Installation

bin/magento channable:selftest

All tests should show "success". If not, check the error messages and review Troubleshooting.

Step 2: Enable the Module

1. Go to Channable → General in your Magento admin
2. Set Enable to Yes
3. Click Save Config
4. Flush cache: System → Cache Management → Flush Magento Cache

Step 3: Configure Your Product Feed

1. Go to Channable → Product Feed
2. Configure the essential settings:

3. Under Product Types → Configurable Products:

   • Use Configurable/Simple Products: Only Linked Simple Products
   • Use Parent URL for Simples: Yes, with Auto-Link
   • Use Parent Image for Simples: Only if Empty

4. Click Save Config

Get Your Feed URL

Scroll down to the Feeds section. You'll see your store views with:

• Preview - Test your feed configuration
• JSON Product Feed - The URL Channable needs
• Auto Connect - Quick connect to Channable

Click Preview to verify your products appear correctly.

Step 4: Connect Feed to Channable

1. Log in to your Channable account
2. Create a new project or open an existing one
3. Add a new import source and select Magento 2
4. Either:
   • Click Auto Connect with Channable in Magento, or
   • Copy the JSON Product Feed URL and paste it in Channable

Channable will now fetch your product catalog.

Step 5: Enable Order Import (Optional)

If you're selling on marketplaces (bol.com, Amazon, etc.), enable order import:

1. Go to Channable → Orders
2. Set Enable to Yes
3. Configure order settings:

4. Click Save Config

Get Your Webhook URL

Scroll to the Webhooks section and copy the webhook URL for your store view.

Configure in Channable

1. In Channable, go to your marketplace connection settings
2. Paste the webhook URL in the order webhook field
3. Save the settings

Test the Connection

Click Import Test Order in the Webhooks table to verify everything works.

Step 6: Enable Product Updates (Optional)

Keep your marketplace stock and prices synchronized in real-time:

1. Go to Channable → Product Updates

2. Set Enable to Yes

3. Configure the webhook per store view

4. Under Settings:

   • Cron Enable: Yes
   • Frequency: Every 5-15 minutes

5. Click Save Config

6. Copy the webhook URL to your Channable account

Verification Checklist

Run through this checklist to confirm everything is working:

• bin/magento channable:selftest shows all success
• Feed Preview shows your products correctly
• Channable successfully imports your feed
• Test order imports successfully (if orders enabled)
• Product updates are being sent (check Product Updates grid)

What's Next?

Now that you're set up, explore these topics:

Fine-tune Your Feed

• Product Feed Configuration - Advanced attribute mapping and filters
• Feed Preview & Debug - Debug individual products

Optimize Orders

• Orders Configuration - Customer handling, invoicing, FBB/LVB
• Test Orders - Test different scenarios

Monitor & Manage

• Orders Grid - Track imported orders
• Returns Grid - Process marketplace returns
• Product Updates Grid - Monitor sync queue

Reference

• CLI Commands - Automation and debugging
• Best Practices - Recommended configurations
• Troubleshooting - Common issues and solutions

Common Setup Issues

Products not appearing in feed

• Check product visibility (needs "Catalog" or "Catalog, Search")
• Verify products are enabled and in stock
• Review filter settings in Product Feed configuration

Orders failing to import

• Verify webhook URL is correct in Channable
• Check shipping method exists and is enabled
• Run a test order to see specific error messages

Feed URL returns error

• Ensure module is enabled
• Flush Magento cache
• Run bin/magento channable:selftest

For more help, see Troubleshooting.

Need More Help?

Documentation:

• All Help Articles

Support:

• Contact Support