If you're using Magento 2 as your e-commerce platform to list products on marketplaces through Channable and need to establish an order connection with one of the supported marketplaces, please follow the guide below.
Table of contents
- Important information
- Configure the Default Store view settings of the plugin
- Activate Product updates in the connected Store view
- How to configure country options in Magento 2 (Optional)
- Set up the order connection within Channable
Important information
-
Configuration responsibility: It is essential to follow the instructions carefully to ensure the Channable Orders plugin functions correctly in Magento 2. You are solely responsible for configuring the Orders plugin properly. We cannot be held liable for any incorrect settings or issues that arise from misconfiguration within Magento 2.
-
Default settings recommendation: This guide is designed to help you set up the Orders plugin using our recommended default settings, which will guarantee optimal performance. While you have the flexibility to customize these settings to suit your specific needs, please keep in mind that any changes beyond the default configuration are at your discretion. We do not provide support for custom configurations.
- Magmodules update: If you have the Magmodules Channable plugin installed in your Magento 2 store, the Order API will be automatically included. Please ensure you're using the latest plugin version by checking the update page.
Step 1: Configure the Default Store view settings of the plugin
Navigate to the Channable plugin shortcut in the sidebar menu and click “Orders” under “Configuration”:
You will automatically be redirected to the “Default Config” where you need to check the following settings:
- Enable: Yes
- Default Shipping Method: Channable Shipping
- Fallback Shipping Method: Channable Shipping
-
Import customers: No
Now, go to the “Product Updates” section of the plugin menu, where you can adjust the settings. In Channable, stock updates will show in the “Orders > Product Updates” tab. Enable the product updates and set the following up:
- Frequency: Custom
-
Custom Frequency: */5 * * * * (this means the stock will be updated every 5 minutes)
- You can edit the Products per run to 20 under “General” at the top of this page:
Next, you can set the invalidation type.
If the Invalidation Type is set to “Cron” instead of “Observer,” only the date on which a product was changed is considered, but not whether it was sold.
If the Invalidation Type is set to “Observer”(recommended), a product is also invalidated when placing an order or manually adjusting inventory in Magento.
Scheduled tasks are managed by the system's cron scheduler for periodic checks on stock and price changes using Magento's "Cron" job.
"Observer" is a script that responds to specific events such as stock and price changes, executing custom logic. While it's the optimal way to observe changes, the observer might miss them if price or stock changes are made directly in the database.
Go back to the top and save the configuration of the default config.
Step 2: Activate Product updates in the connected Store view
If you have activated the Product Updates in Step 1, go to the Channable plugin and click on “General”. Select the configuration of the store view (or scope) that is connected to Channable.
If you have multiple store views connected to Channable (for example, for multiple countries in separate Channable projects), make sure you go to the right store view: the one that is connected to the Channable project you want the order connection set up. You can check which store view you have connected to Channable by going to your project in Channable and navigating to “Setup > Setup import > [Magento import] Settings". Now, click on the Magento connection to see the configuration, including the Store ID.
In the correct store view or scope, activate the Product Updates. The webhook field will remain empty and will automatically be filled after the order connection is configured and activated in Channable.
How to configure country options in Magento 2 (Optional)
Configuring country options in Magento 2 is crucial when processing orders from different countries. If this setup is not done correctly, any order received through Channable for a country not listed in Magento cannot be imported into your store.
- Navigate to Stores > Configuration.
- Under General, select Country Options.
- Configure the following settings:
- Default country: Choose the country where your business is located.
- Allow countries: Select the countries from which your store will accept orders.
- Click on "Save Config" in the top right of your screen to save your changes.
Step 3: Set up the order connection within Channable
After you have configured the above settings, the Channable Orders plugin in Magento is ready for the order connection. To set up the order connection within Channable, you can follow the steps in this article.