Overview

Integrate with WooCommerce to import your orders and create shipment labels.

The integration can also write back tracking information to these orders after printing your shipment labels. 

1. Generate your API key in WooCommerce

In order to import orders from your store, DHL Express Commerce needs some information which can be found in your WooCommerce dashboard.

1. From your WooCommerce dashboard, select WooCommerce > Settings.
2. Click the Advanced tab.
3. Select REST API near the top of the screen, then click Add Key.
4. In the Description field, enter 'Integration'.
5. Select a user.
6. In the Permissions menu, select Read/Write.
7. Click Generate API key.
8. Copy the Consumer Key and Consumer Secret. You will have to paste this in the DHL Express Commerce integration settings.

Note: If you want to use the Legacy Version 1 or Legacy Version 2 integrations, you will need to enable the Legacy API on WooCommerce. Using the legacy integrations is not recommended.

1. From your WooCommerce dashboard, select WooCommerce > Settings.
2. Click the Advanced tab.
3. Click Legacy API near the top of the screen.
4. Tick Enable the legacy REST API.
5. Click Save changes.

2. Add WooCommerce as an integration

1. Log in to DHL Express Commerce
2. In your account, go to Settings, then select Integrations.
3. Click Add a new integration, and select WooCommerce from the list.
4. Select the Enable WooCommerce checkbox.
5. Under WooCommerce API version, select Latest Version 3.
6. Enter your store URL.
   If you do not know your store URL, check your WooCommerce dashboard > Settings > General > Site Address (URL).
7. Paste your Consumer Key and Consumer Secret copied from WooCommerce.
8. Enter or select your Status to import.
9. Fill out any other details as required. 
10. (Optional) Select Enable writeback to the customer instructions field. DHL Express Commerce will write-back the Tracking Number, Carrier Name and Tracking URL in the instruction field.
11. (Optional) Select Enable customer notifications when creating order note on writeback. Customer notifications will automatically be sent when DHL Express Commerce writes back the tracking details in a note.
12. Click Save.

Note: If the writeback feature is blocked or fails to work, change the Order Update Method to 'POST'. DHL Express Commerce > Settings > Platforms > WooCommerce > Settings > Order Update Method > 'POST'

3. Set your writeback method

Writeback is when DHL Express Commerce sends back tracking information to WooCommerce. 

With the Latest Version 3 WooCommerce integration you can configure two different writeback methods.

To configure your writeback method follow the below steps:

1. In your DHL Express Commerce account, go to Settings, then select Integrations.
2. Click Settings next to WooCommerce.
3. Scroll down until you see the option Writeback Method.
4. From the dropdown select either of the two options:
   • Create an Order Note
   • Update using Shipment Tracking Plugin

Create an Order Note

When an order in DHL Express Commerce is printed or manifested, DHL Express Commerce will set the order status to complete in WooCommerce, and add an order note to the order.

You can also set the order note created to also trigger a notification to the customer. To do this enable the Enable customer notifications when creating order note tickbox option in WooCommerce settings when you have the Create an Order Note writeback method selected.

Update using Shipment Tracking Plugin

This method allows you to use the WooCommerce Shipment Tracking Plugin. The plugin adds tracking fields into WooCommerce as there are no native fields on WooCommerce.

 

You can purchase the plugin and find instructions for installing it here.

 

By using the plugin to add these fields, you can setup other integrations with WooCommerce (like Amazon, eBay and The Iconic) to read from these fields for the purpose of writing back to those platforms when an order is shipped.

4. Live rates at checkout

To activate live DHL Express shipping rates at your WooCommerce checkout, see this article. 

Rates at checkout for WooCommerce