The plugin enables complete order processing between marketplaces and your shop, repricing for your products through market price analysis and product export.
Step 1: Install the plugin
Navigate to the modules section in PrestaShop and click "Module Manager" (No. 1)
Then click "Upload a module" and choose the plugin zip to upload (No. 2-3).
Activate the installed Plugin in the modules-overview.
After the plugin installation, go to Channel Pilot Pro and create a new shop.
Step 2: Set up the plugin
Go back to PrestaShop and navigate to the recently installed plugin
Modules -> Module Manager -> Configure
There are 4 different blocks of settings here:
General Settings (No. 4)
CP Check IP?: Check the used IP? (Black- and Whitelisting possible)
Article Number: Select which data field you want us to use to identify your products.
FeedExport (No. 5)
Activate FeedExport: Activate or deactivate the export.
Password: You can enter a password.
If you do, the password has to be added to the "Hook-URL" to make the export work.
Product attributes to export: Choose which attributes you want in your export.
Include products without stock in the FeedExport: Enable/disable this option to in- or exclude articles without stock.
CP_EXPORT_PRICE_WITH_TAX?: Export base price with or without tax.
Your export feed: Shows the download-url of your export, including the password if set.
CP Prices (No. 7) and CP Marketplace (No. 8)
CP Activate Prices: Activate or deactivate the Hook for "Repricing". More information on "Hooks" you will find at the bottom of the page.
CP Activate Marketplaces: Marketplace connection can be activated or deactivated.
New order paid: Choose the standard display for paid orders.
New order not paid: Choose the standard display for unpaid orders.
Cancellation: Choose standard display for order cancellations.
Delivery: Choose standard display for delivered orders.
If all settings are done, click "Save". The plugin can be used now.
Make sure you created a functional shop with the correct settings.
Communicate the name of the shop(s) (if there is more than one) to your account manager, who has to make final steps for activation.
Step 3: Plugin function and hooks for manual synchronization
The plugin runs automatically (default every 15 minutes) and triggers the following functions:
import new orders
synchronize deliveries
synchronize cancellations
synchronize new price information (if repricing is used)
The initiator of the cyclical communication is always Channel Pilot Pro. Therefore, no cronjobs or other timed processes need to be implemented in the plugin / shop system. Channel Pilot Pro controls the plugin.
These actions can be triggered with hooks manually. We recommend using them only for test cases or for error handling.
These "Hook-URLs" are provided by the shop system, and each one covers the above described use cases. The procedure for calling a "Hook-URL" is divided into the following sections:
Channel Pilot Pro calls a "Hook-URL" (https://www.shop.de/channelpilot?method=USE_CASE)
Plugin calls the Seller API and sends / receives new data.
Plugin updates data in the shop system.
Plugin responds to the "Hook-URL".
These are the URLs which can be used up to version 1.7.8.9:
STATUS (checks if the plugin is registered successfully. Provides more information for other hooks) → https://SHOPDOMAIN/modules/channelpilot/handler.php?method=status
REGISTRATION → https://SHOPDOMAIN/modules/channelpilot/handler.php + Multishop ID
EXPORT → https://SHOPDOMAIN/modules/channelpilot/handler.php?method=xmlexport&language=1 (please select the correct language, the link is visible in the plugin export settings)
From version 8.1, the following hooks must be used:
STATUS (checks if the plugin is registered successfully. Provides more information for other hooks) → http://SHOPURL/modules/channelpilot/handler.php?method=status&token=APITOKEN&php=PHPVERSION8&shop=PRESTASHOPVERSION&plugin=PLUGINVERSION&limit=10
Order handling
Partial Cancellation / Partial Return
Go to PrestaShop and navigate to order, you want a partial cancellation or partial return for.
Open the corresponding order and click on "Partial refund".
Select the product and / or quantities from the order.
Click on "Partial refund".
If it’s a refund before shipment (i.e. cancellation), the action in PrestaShop will automatically trigger a “Partial Cancellation” to the marketplace via Channel Pilot PRO.
If it’s a refund after shipment (i.e. return), the action in PrestaShop will automatically trigger a “Partial Return” to the marketplace via Channel Pilot PRO.
Cancellations with different statuses
Only available for Version 8.1 or higher
To handle cancellations with different statuses in PrestaShop, you can multi-select the different statuses in our module settings -> CP Marketplace (No. 8):
