# Set up DHL eCommerce Asia Pacific
URL: https://support.starshipit.com/articles/204681005-set-up-dhl-ecommerce-asia-pacific
Canonical: https://support.starshipit.com/articles/204681005-set-up-dhl-ecommerce-asia-pacific
Markdown: https://support.starshipit.com/articles/204681005-set-up-dhl-ecommerce-asia-pacific.md
Updated: 2026-05-06

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Step-by-step guide to setting up DHL eCommerce asia pacific.

* DHL eCommerce Asia Pacific's integration with Starshipit allows you to generate packing slips and shipping labels, send branded tracking notifications, generate live rates at checkout and writeback tracking to your chosen platform.
* This article outlines how to set up [DHL eCommerce Asia Pacific](https://www.dhl.com/global-en/microsites/ec/ecommerce-insights/about-dhl-ecommerce.html) as a courier service in Starshipit.

## Before you begin

You'll need the following:

* DHL eCommerce Asia Pacific account numbers (Pick Up and Sold To)
* DHL eCommerce Asia Pacific Dispatch ID
* Product codes

If you don't have these credentials, please contact your DHL account manager to request this. Alternatively, you can contact our support team [here](https://help.starshipit.com) with your DHL eCommerce Asia Pacific account number and we can request credentials on your behalf.

## 1. Add your DHL eCommerce Asia Pacific details in Starshipit

1. In Starshipit, navigate to **Settings** > **Couriers** > **Add a new courier**.
2. Select that country you are shipping from in the drop-down.
3. Select **DHL eCommerce Asia Pacific**.
4. Tick **Enable DHL eCommerce Asia Pacific**.
5. Complete the fields **Pick Up No**, **Sold To No** and **Prefix Code** with your details.
6. Select **Use the API to generate labels and manifests**.
7. Enter your **Pick up** and **Sold To** numbers.
8. Click **Save**.
## 2. Set up your product codes

Add your product codes to complete the integration.

1. Click **Add a new product code**.
2. Fill in details as required.
3. Click **Add**.

## Live quotes for shipments

Starshipit supports displaying live quotes for your DHL eCommerce shipments using DHL eCommerce's technology "Gemini". These quotes will be based on your rate card with DHL eCommerce. This is enabled on all DHL eCommerce shipments automatically.

## Advanced settings

#### Generate Customs Invoice

You can generate a commercial invoice for your DHL eCommerce Asia Pacific international shipments. To enable this feature:

1. Navigate to **Settings** > **Couriers** > **DHL eCommerce Asia Pacific** > **Advanced**.
2. Tick **Generate Customs Invoice for International Orders**.
3. Click **Save**.  
#### Default Handover Methods

You can set the default handover method when you manifest orders for DHL eCommerce.

If you see an error message "Shipment(s) not allowed for handoverMethod - 2", under the dropdown options, select the **Drop-Off** option then click **Save**.

#### 

#### Ensure the order number is incorporated into the tracking number

DHL eCommerce can adjust the tracking number/shipmentID used, which is useful for matching shipments sent with DHL eCommerce to the original order number. The format for this adjustment will be:

```
<yourDHLshippingprefix> + ordernumber + 00 (padded to 9 characters)
```

To activate this feature on your account:

1. Go to **Settings** > **Couriers** > **DHL eCommerce Asia Pacific**.
2. Check the box for **Use OurRef for the ShipmentID**.
3. Press **Save**.

## Configure DHL eCommerce Asia Pacific settings

The settings are divided into **Settings**, **FTP**, **Testing**, and **Advanced**:

| Setting | What it controls |
| --- | --- |
| **Enable DHL eCommerce Asia Pacific** | Enables the courier. |
| **Use the API to generate labels and manifests** | Uses the API workflow instead of the FTP workflow. |
| **Use Staging URL** | Uses the test endpoint. Leave it off for live shipments. |
| **Use OurRef for the ShipmentID** | Includes your order reference in the shipment ID. |
| **Prefix Code** | The DHL prefix used for shipment IDs. |
| **Pick Up No** and **Sold To No** | DHL account numbers used for pickup and billing. |
| **FTP Account No** | The account used when the FTP workflow is selected. |
| **Use sender phone/email if destination is blank** | Provides sender contact details as a fallback. |
| **Use Default Item Description for Items** | Uses the default item description from **Settings > Options**. |
| **Display SKUs in label** | Prints item SKUs on labels. |
| **Automatically manifest** | Manifests orders automatically at the end of the day. |
| **Generate Customs Invoice for International Orders** | Creates a customs invoice for international shipments. |
| **Set DTP for all services** | Applies the selected duty-and-tax-paid value to services. |
| **Default Handover Methods** and **Default Return Methods** | Sets the handover and return methods sent to DHL. |
| **Content Export Description** | The description used for international content exports. |

The **Testing** tab contains manifest test actions such as manifesting outstanding orders, forcing all orders, and re-manifesting tracking numbers or a manifest. Use these actions only when testing or recovering a manifest.