If you're experiencing issues with your orders not being imported into ChannelDock, in this article we will outlines the steps you should take to identify and resolve common issues related to order imports.
Check for errors in the API logs
Identifying errors in your API logs is the first step to understanding what might be going wrong. For detailed instructions on how to review your API logs for potential errors, click here.
Magento-Specific Errors and Fixes
Orders Failing to Import
Cause: Missing user permissions in Magento for viewing orders. Without the necessary permissions, Magento returns an HTTP 401 Unauthorized error when ChannelDock requests orders via the API. Solution:
Log in to the Magento Admin panel.
Go to System → Permissions → User Roles.
Open the role assigned to the admin user used for the ChannelDock integration.
Enable the following permission: Sales → Orders → View (permission key:
Magento_Sales::actions_view).Save the role.
Retry the API call by triggering a manual sync in ChannelDock:
Go to Connections → Sales channels → Actions → Sync API.
Confirm that orders now appear in ChannelDock.
No Product Attached to This Order and No Barcode Found
These errors indicate that the products associated with the orders haven't been imported into ChannelDock. To resolve this:
Ensure your products are correctly set up in your sales channels. For guidance on correcting these errors in your sales channels, click here.
After correcting the issue in your sales channels, importing the products manually into ChannelDock should resolve the order import issue. For instructions on manual product import, click here.
Verify order status
Orders that have been processed or closed in your sales channels will not be imported into ChannelDock. Ensure that the orders you expect to see are still open and unprocessed in your sales channels.
Stock Updates Not Syncing
Cause: Cloudflare protection on the Magento domain blocks ChannelDock’s API requests. Instead of a normal API response, Cloudflare returns a challenge page, preventing inventory synchronization. Solution:
Log in to your Cloudflare account.
Navigate to the settings for the affected Magento domain.
Whitelist ChannelDock’s production IP address to allow API requests.
Save the changes and verify that stock updates are syncing correctly.
Still need help?
If you've followed all the steps above but your orders are still not being imported into ChannelDock, please contact our support team for assistance.