Overview
- Integrate DHL Express Commerce with BigCommerce to import your orders and ensure tracking information is written back when you print a label.
- This article outlines how to integration your BigCommerce platform with DHL Express Commerce.
What's covered in this article
- How to set up BigCommerce in DHL Express Commerce
- Advanced settings and information
- Manage multiple storefronts
How to set up BigCommerce in DHL Express Commerce
1. Create an API user in BigCommerce
- Before you can integrate with BigCommerce, create a user API account for BigCommerce. Ensure you select V2/V3 API token when creating the API account.
- Set the OAuth scopes.
Note: You only need to define the scopes listed below while leaving any other unlisted settings unchanged.
| Name | Scope |
|---|---|
| Content | modify |
| Checkout Content | modify |
| Customers | modify |
| Customers Login | login |
| Information & Settings | modify |
| Marketing | modify |
| Orders | modify |
| Order Transactions | modify |
| Create Payments | create |
| Get Payment Methods | read-only |
| Products | modify |
| Themes | modify |
| Carts | modify |
| Checkouts | modify |
| Sites & Routes | modify |
| Channel Settings | modify |
| Channel Listings | modify |
| Storefront API Tokens | manage |
| Storefront API Customer Impersonation Tokens | Manage |
Take note of the API Path, Client ID and Access Token supplied by BigCommerce as you will not be able to view your credentials again.
2. Copy the API information into DHL Express Commerce
Once you have generated the API credentials from BigCommerce, you need to enter your credentials in the DHL Express Commerce settings pages.
- In DHL Express Commerce, go to Settings > Integrations > Add a new integration > BigCommerce
- Choose a name that will help you to differentiate this store from your other BigCommerce stores
- Leave the Username field empty; it is not used by the integration that you are performing
- Complete API Path, Client ID, Access Token with the information from BigCommerce.
- Click on Save
3. Status to Update
You can select the status of the orders you wish to import using the following BigCommerce order status codes:
- Status 9 = Awaiting Shipment
- Status 11 = Awaiting Fulfillment
- Status 2 = Shipped [For Update Order]
- Status 10 = Completed [For Update Order]
See the entire list of order status codes.
4. Import your orders
- Click the Shipments tab at the top of the page in DHL Express Commerce.
- Once you are on the Shipments page, click the Import button, and select BigCommerce and the number of days you wish to import.
- Click Import at the bottom right.
- After a brief load time, the number of imported orders will be displayed.
- Click Close and your shipping page will reload with the newly imported orders.
Advanced settings and information
-
Product Options: DHL Express Commerce will import the product options with the following display names:
- Size
- HS Code
- Color or Colour
- Pick up in Store: If you would like to use DHL Express Commerce for Pickup in Store orders select "Enable Pickup in Store". This setting enables any shipments printed with a Pickup In-Store carrier to have it's status updated to "Awaiting Pickup" upon Writeback
Manage multiple storefronts
Use DHL Express Commerce to manage multiple storefronts in BigCommerce seamlessly.
With the Import Channel ID as a tag setting, you can:
-
Filter orders
Use the orders grid to filter by specific store IDs -
Create rules
Automate workflows using tags, e.g. "If Tag = [Storefront ID], assign to X account" or "Set carrier to X".
This rounds out our BigCommerce storefront offering, as we also support writeback for multi-storefront setups.
How it works
When enabled, this setting automatically tags the order with the Storefront ID when they are imported into DHL Express Commerce.
How to enable it
- Navigate to Settings > Integrations > BigCommerce.
- Scroll to the bottom of the page.
- Tick the checkbox for Import Channel ID as a Tag.