IN THIS GUIDE
Order Desk requires WooCommerce 3.0 or above.
Order Desk can connect to your WooCommerce shopping cart and download your orders.
This guide explains how to set up and use the WooCommerce integration in Order Desk.
Before connecting the integration in Order Desk, you will first need to go into WordPress and make sure the Legacy API is enabled. To do this, in WooCommerce, click on Settings > Advanced > Legacy API.
In Order Desk, click on Manage Integrations under the Integrations menu in the left sidebar. Under the Shopping Carts tab, find and enable WooCommerce.
Alternatively, search for WooCommerce from the available integration search.
You will get a link to authorize Order Desk to connect to your site. If this doesn’t work, you can create the authorization keys yourself and input them into Order Desk directly. All keys should be Read/Write. To create your API keys manually, in WooCommerce, click on Settings > Advanced > REST API.
Troubleshooting Your Connection
If you are unable to connect Order Desk to your site, there are a few things to check:
- First, make sure the URL you entered is consistent with the WordPress URL settings.
- If it still isn't connecting, go back into your WordPress account and click on Settings > Permalinks in the WordPress admin. Loading this page will rebuild your permalinks and can fix a corrupted permalink problem.
- Double check that you are using a permalink method like “Post Name” and not the default ("Plain") option. The WooCommerce REST API requires the use of pretty permalinks in order to be accessible.
- If you have iThemes Security installed, make sure that the “Filter Suspicious Query String URLs” feature is disabled.
If you still aren't able to make the connection, please contact Order Desk support for assistance.
Once connected, set your preferences in the WooCommerce Settings.
Select Enabled if you want your WooCommerce orders to instantly come into Order Desk as they're placed. When you first connect to WooCommerce, if you enable this setting, Order Desk will pull in your orders from the previous seven days. To pull in older orders, use the manual import option.
If instant download is enabled but some of your orders aren't coming in, make sure to set up your backup check schedule.
Backup Check Schedule
The backup check schedule is a scheduled appointment to check WooCommerce for any new orders. If instant download is enabled, the backup check schedule will run in the background in case any orders were not downloaded when they were placed. This can happen if an order status is initially incomplete or not paid. The instant download will not be able to pull those orders in immediately, but the backup check will find them after the status is updated.
If instant download is disabled, the backup check schedule can be used to pull in orders on the schedule you select instead.
Folder for New Orders
When orders are first download from WooCommerce, they will be placed in the folder selected here.
For more information, see Working with Folders.
Sync Tracking Numbers
If enabled, shipment notices will be sent back to WooCommerce as tracking details are added to your orders in Order Desk.
This will write a customer note back to the order at WooCommerce when an order has been shipped. It will also tell WooCommerce to email an update to the customer if that setting is enabled in WooCommerce.
Because WooCommerce only accepts tracking details as a customer note, many WooCommerce merchants prefer to use Order Desk to notify customers of shipments.
Mark Order Completed
If enabled, the order status will be changed to completed in WooCommerce when the shipment is added to the order.
If enabled, Order Desk will update WooCommerce with your inventory counts if any changes are made your items in Order Desk.
For more information, see How to Work with Inventory Counts.
First Import Date
Any orders previous to the date set here will not import into Order Desk.
Use two digit country codes, separated by commas, to only import orders from specific countries.
Add a - to exclude orders from specific countries.
US,CA,MX - only import orders for the United States, Canada and Mexico.
-US,-CA,-MX (or -US,CA,MX) - import all orders except for the United States, Canada and Mexico.
Inventory Location Filter
If you only want to download specific orders, you can use the Inventory Location Filter field to specify which ones you want. Enter multiple locations separated by a comma.
The inventory location name must match exactly as it is on your inventory items in Order Desk. When importing new orders from WooCommerce, Order Desk will look at the SKUs on the items and compare to the SKUs in your inventory here. Any orders with items for a location that isn't listed in this field will not be imported.
If you need to, you can add a prefix of your choice that will be added to all orders downloaded from WooCommerce.
Download Order Meta as Checkout Data
If selected, you can bring in your order meta details as checkout data fields
For more information on what checkout data is and how it can be used in Order Desk, see the How to Work with Checkout Data guide.
Download Extra Details About Products
Select this setting if you want to bring in extra product details with your WooCommerce orders.
- The product thumbnails, which will be displayed with the items in the order.
- The regular price value, which will be stored as item metadata.
- Product attributes, which will be saved as item variations.
If this option is selected, orders will take a little longer to import. This shouldn't be a concern for lower volume stores, but if you get high volume from WooCommerce or your orders have a large number of items in them, we recommend keeping this setting disabled unless you specifically need these details.
Use New API Version
If selected, Order Desk will use the latest version of WooCommerce’s API. When Use New API Version is enabled, we’ll automatically support the official WooCommerce plugin that adds multiple shipping addresses to a single order. The order will be split by shipping address, and the shipping cost, tax, discount and handling will also be split proportionately.
Enable Shipment Tracking Plugin Support
If you use the official Shipment Tracking Plugin with WooCommerce, enable this setting for Order Desk to communicate shipment info properly to your WooCommerce store.
If you need to manually import orders or inventory items from WooCommerce, you can do this from the WooCommerce integration page.
Manually Import Orders
Order Desk can download 50 orders at a time from the date you set here. You may need to click to import orders a few times if you have a large volume of orders from the date chosen.
Manually Import Inventory Items
If you need to pull your WooCommerce inventory into Order Desk, click the Import Inventory Items Now button.
When setting up and importing orders from WooCommerce, you may come across some errors that can be vague and hard to understand. For a list the most common WooCommerce errors and how to resolve them, please see the WooCommerce section of the Common Errors guide.
If you use GoDaddy, you might encounter some problems updating your WooCommerce inventory. GoDaddy's firewall blocks certain required Order Desk calls, so we have built in a special feature to address this. We can apply this fix to your store, so please contact Order Desk support if you suspect you are having this problem.