Set up CIN7 Core integration

Overview

The steps below will guide you through integrating your CIN7 Core (formerly DEAR) platform with DHL Express Commerce. Once completed, your orders will be imported into DHL Express Commerce and the tracking information will be written back when you print a label.

What you need to get started:

Before getting started with CIN7 Core you will need a few things.

Your CIN7 Core Account Id
Your CIN7 Core API Key

If you do not have the above fields, follow the below steps:

Log into Cin7 Core.
Go to Integration > Cin7 Core API
Click the + icon to create a new application
Ensure you note down the API key that is shown in the prompt
On the next screen, ensure you've noted down the Account ID and then click save

How to set up CIN7 Core:

To enable CIN7 Core on your account:

Go to DHL Express Commerce > Settings > Integrations > Add a new integration > CIN7 Core
Recommended: Select Version 2 for the API version.
Enter in the Account ID and Key from CIN7 Core
Click Save

Writeback

DHL Express Commerce will update your orders with carrier and tracking information when shipped. By default, DHL Express Commerce will use "DEFAULT Carrier" when updating your orders in CIN7 Core.

If you wish to have your CIN7 Core orders to be updated with the specific carrier name then you will need to set up Carrier Mappings in DHL Express Commerce.

Go to Settings > Integrations > CIN7 Core > Courier Mappings
Click Add a new mapping
From the courier drop down, select one of your enabled couriers
In the courier name to use textbox, enter in the courier name you have defined in CIN7 Core
When done, click the tick icon

When writeback is attempted for the courier specified, we will send back the courier name you have defined in this field

Additional Configuration

Status to import: Use this option to specify what status orders should be in to import into DHL Express Commerce. You can specify multiple by separating each status with a semi colon. For example: Ordering;Picked

Advanced Sales: If you are using CIN7 Core's Advanced Sales - Multiple Fulfillments you can configure your DHL Express Commerce integration to import each fulfilment and a single order, instead of importing the overall sales orders.

To do this, you will need to be on CIN7 Core Version 2 and select "Import Sale Fulfillments instead of Sales". This means you will have multiple DHL Express Commerce orders for the one order in CIN7 Core allowing you to ship them separately with ease.

Import Memo/Order Notes: By default DHL Express Commerce does not import memo's from CIN7 Core. If you would like these to import into the delivery instructions field, select the option you would like from the memo drop down. Alternatively you can import the order notes by selecting Import order note into delivery instructions

Use contact field as company name: By default, DHL Express Commerce will use Customer as the contact name, however, you can use this option to use the sale.ShippingAddress.Contact field for the DHL Express Commerce receiver address company field instead.