WooCommerce

DSTNC's WooCommerce integration is designed as an end-to-end model that allows us to pull in product details, inventory levels and pricing, and facilitate order placement.

WooCommerce is a third-party plugin that empowers the Opensource WordPress Content Management System with e-commerce capabilities.

As long as the WordPress plugin purposed for eCommerce is WooCommerce, DSTNC will be able to download products, and inventory, and send orders accordingly.

Any other WordPress plugin is currently not supported by DSTNC.

Getting Started

To get started, DSTNC will need a valid set of API credentials to communicate with your store. Pre-generated keys can be used to authenticate the REST API endpoints. New keys can be generated either through the WordPress admin interface or they can be auto-generated through an endpoint.

Generating API Keys In the WordPress Admin UI

1. To create or manage keys for a specific WordPress user, go to WooCommerce > Settings > Advanced > Rest API.

2. Click the "Add Key" button. In the next screen, add a description and select the WordPress user you would like to generate the key for. Use of the REST API with the generated keys will conform to that user's WordPress roles and capabilities.

   

3. Choose the level of access for this REST API key, which needs to be Read/Write access to sync inventory and orders. Then click the "Generate API Key" button, and WooCommerce will generate REST API keys for the selected user.

Now that keys have been generated, you should see two new keys, a QRCode, and a Revoke API Key button. These two keys are your Consumer Key and Consumer Secret. It's the Consumer Key and Consumer Secret that DSTNC needs to communicate with the store.

If the WordPress user associated with an API key is deleted, the API key will cease to function. API keys are not transferred to other users.

Generating the Legacy API

The Legacy API is commonly used by DSTNC in case the brand is on an older version of WooCommerce, or there are known issues with the standard API.

To enable the Legacy API, you will need to access the WordPress admin panel. Go to WooCommerce > Settings > Advanced > Legacy API, and check the option for enabling it.

This should now allow the rest of the connection to work properly.

Troubleshooting

If you are not able to successfully sync your merchant's WooCommerce store with DSTNC, read below for some tips on resolving the issue. For more tips on debugging WooCommerce connection issues, see this helpful support article from WooCommerce.

What version of WooCommerce are you using? Jetti only works with WooCommerce 2Changing The Language REST API enabled? In your WordPress Admin, go to WooCommerce -> Settings -> General and make sure the Enable the REST API option is checked.

Even if you’re using WooCommerce 2.1.7+, try upgrading to the latest version of WooCommerce. There may be a bug in your version of WooCommerce that has been fixed in the latest version.

If you’ve been able to connect in the past and can no longer connect, have you installed any new plugins?

Do you have iThemes Security installed? Ensure that “filter suspicious query string URLs” is disabled under Security > Settings > System Tweaks.

If you come across an error when connecting DSTNC to a WooCommerce store, it might be because the legacy API is not enabled in your WooCommmerce store.

Syncing Inventory Levels

Inventory management works slightly differently in WooCommerce than in some other platforms. There isn't always a clear equivalent setting between the two systems. To reconcile the differences, here is how the stock will sync:

• If Inventory tracking is turned off in WooCommerce AND the item IS marked as In Stock, the item will be set to Don't track inventory on DSTNC, and the item WILL be purchasable on DSTNC.

• If Inventory tracking is turned off in WooCommerce AND the item IS NOT marked In stock, the item will be set to DSTNC tracks this product's inventory, the inventory quantity will be set to 0, and the item WILL NOT be purchasable on DSTNC.

• If Inventory tracking is turned on in WooCommerce, the item will be set to DSTNC tracks this product's inventory, the inventory quantity from your store will be synced, and the item will be purchasable depending on whether the quantity is greater than 0.

Changing the Language

WooCommerce isn't multi-language out of the box. However, you may install a 3rd party plugin to translate the content. By default, the language of your store will typically be imported. However, there may be a way to override this by bringing in an alternative language.

We may not be able to support every WooCommerce language plugin.

It is not possible to automatically translate content if the content is in another language AND a plugin is not being used.

Importing Tracking Details

There are some known restrictions that may limit DSTNC's ability to import tracking details from WooCommerce.

Out of the box, WooCommerce does not have a way to store tracking information. Or, ways to partially ship orders. DSTNC will detect when the order is complete and mark it as shipped, but there will be no tracking information.

In order to integrate with DSTNC, you will need to install 3rd party add-ons to support tracking being added to orders. DSTNC currently supports the official 3rd party plugin: https://woocommerce.com/products/shipment-tracking