DHL – User Guide

To integrate DHL with the ShipX app, you will need the following credentials:

DHL Production API Key

Secret Key

DHL Account Number

Follow the steps below to obtain these credentials and connect DHL with your ShipX account.

How to obtain DHL Account Number, Product API Key and Secret Key

Step 1: Obtain DHL account number

Go to the DHL Business Registration Portal to begin the registration process.

Complete the registration form by providing your business name, contact details, and other required information to create a new DHL account.

Once your account is created, log in using your registered email address and password.

In your DHL dashboard, go to My Shipment Settings.

Your 9-digit DHL Account Number will appear under the Export Shipments section.

Make a note of this number, you’ll need it during the integration process.

Step 2: Obtain DHL Production API Key and Secret Key

Go to the DHL Developer Portal to request API access.

Once logged in, click Onboarding Form and fill out the required details to request API access for your business.

After submitting the onboarding form, DHL will email you test API credentials. These are for testing and development purposes only.

Return to the Developer Portal, navigate to My Apps, and confirm that your app is listed and its status shows Approved.

From the Apps page, click Request Production Access to upgrade your app from test mode to production mode.

Once approved, DHL will email your Production API Key and Secret Key.

Save these credentials securely, they’re required for integration with ShipX.

How to sync DHL with ShipX

Follow the steps below to connect your DHL account and fetch live carrier rates in ShipX.

1. Go to Rates and click View on Scenarios.

2. Select the scenario where you want to add DHL rates.

3. Under shipping rates, click Add shipping rate on the preferred shipping zone.

4. Select Live carriers as your rate type.

5. Enter a name for your shipping rate.

6. Choose DHL as your live carrier and click Sync.

7. Enter your DHL credentials:

API key

Secret key

Account number

After entering the details, click Save.

8. Under shipping location, choose Use Shopify location, or Specify different location.

9. Under service by carrier, select how you want to display services:

Show all services

Show service with highest rate

Show service with lowest rate

10. Enable Custom declarable - non dutiable option if your shipments are non-dutiable.

11. Select the services you want to offer from UPS.

12. Choose your packaging method:

Pack by cart attributes: Create packages based on weight, volume, quantity, or total value.

Pack each product separately: Every product is packed individually.

AI-based packaging algorithm: Automatically finds the most efficient box combination using item dimensions and weights.

13. If you selected Pack by cart attributes or AI-based packaging algorithm, click Add package to add your packaging boxes.

14. Enter your package details:

Package name

Package max limit

Package dimensions (Length x Width x Height)

Empty box weight

Click Add package or Add.

ℹ️

Note: For AI-based packaging algorithm, enter the inner and outer dimensions of packages to calculate the shipping rates.

15. Set a fallback rate to prevent shipping losses if the carrier fails to fetch a live rate.

16. Click Save to complete the setup.

Troubleshooting and Support

If you experience issues while generating or validating credentials:

Recheck your API Key, Secret Key, and Account Number for accuracy.

Verify that your app status in the DHL Developer Portal is Approved and set to Production.

Contact the DHL Support Team for assistance with onboarding or API activation.

ℹ️

Note: Steps and interface options may vary depending on your DHL region or account type. Always refer to the official DHL Developer Documentation or contact DHL Support for the most accurate and region-specific guidance.

If you need further assistance, please contact our customer support team.