DHL GLOBAL

In this Guide

DHL Global

Account Numbers and Services

When you add a new DHL Global carrier account, the page to enter the DHL Global account numbers for the various DHL Global services appears. On this page, you also select the DHL Global services with which you will ship packages from this location.
To configure DHL account numbers and services, complete these steps...

  1. From the Carrier drop-down list, select DHL Global.

  2. In Unit ID field, type the five-digit Unit ID that DHL assigned to you for use at this location.

  3. In the Account Number field, type the nine-digit account number for this DHL account.

  4. In the Carrier Code field, type a name for the carrier as you want it to appear in the Configuration Tool (Web Admin) tree in the left panel and in the Parcel shipping application. For example, if you are setting up more than one DHL Global account for this location, you might want to assign carrier codes such as DHLG-1, DHLG-2, etc.

  5. In the Services section, select the services to ship DHL packages from this location, and then click ADD to move them from the left-hand column to the right-hand column. To add all of the services at once, click ADD ALL.

  6. You can also use the UP and DOWN to change the order of the services in the list, or select a service and click REMOVE to remove it from the list.

  7. When you are done configuring this page, click ADD in the lower-right corner of the page to save the settings. Otherwise, click Cancel to cancel the settings.

To continue configuring DHL Global, complete the following section .

Account Defaults

Overview

Use the following tabs on the DHL Global Account Defaults page to configure the default information to use with this DHL account.
Tabs

Account Tab

Use the Account tab on the DHL Global Account Defaults screen to enter the account information for this DHL Global account.
Top section

Language

From the drop-down list, select the language to be used in making requests to the DHL XML-PI Web service.

Customer Charge

Type the fee that will be added to every order as two decimal percent or currency value without the currency symbol; for example, if the Customer Charge Type is Fixed (see following row) and the customer charge is £1.00, type 1.00 without the currency symbol; if the Customer Charge Type is Percentage, and the charge is 10% of the total charge for a shipment, type 0.10

Customer Charge Type

From the drop-down list, select the type of customer charge:

  • Fixed – The charge is a fixed amount

  • Percentage – The charge is a percentage of the total charge for the shipment

Shipment Processing section

Suppress Capability and Quote

Select this check box to suppress the return on Ship of any information except base rate and fuel surcharge. If this check box is selected, Parcel does not return charges for any special services and does not perform validation on available services. Use this option if necessary to improve performance.
Caution: Selecting this option may cause operational issues due to limitations in the DHL XML-PI validation of a Ship request. Therefore, choosing this option requires careful manual validation to ensure that selected services and special services are supported for particular origin-destination pairs, etc. See the following section.
Note: By default, this option is not selected.

Suppress ShipmentRequest for PSHP

Select this check box to suppress XML-PI ShipmentRequest after Capability and Quote request for Pre-ship.

PLT Shipments section

Paperless Trade (PLT)

Select this check box to enable DHL PLT service for all dutiable (non-documents) international shipments. If this check box it not selected, then it is considered as a regular shipment and all the international document can be viewed and printed at the end of the shipment.
Note: By default, this option is not selected.

Digital Signature

Enter a path to the file of your digital signature.
Note: The PNG, GIF, JPEG, JPG are the valid format of digital signature.

Company Logo

Enter a path to the file of your company logo.
Note: The PNG, GIF, JPEG, JPG are the valid format of company logo.

DHL Invoice Language

From the drop-down list, select the DHL Invoice Language.
Note: 'English' is selected by default.

DHL Invoice Type

From the drop-down, select the DHL Invoice Type. The values available for selection are:
• Commercial Invoice
• Proforma Invoice
Note: 'Commercial Invoice' is selected by default.

BBX Shipment Details section

Empty Handling Unit Weight

Enter the Mother Piece Handling Unit Weight. The Maximum number of characters allow for the value of this field is 11 including decimal. If user does not enter any value in this field, then it is treated as zero.
Note: This field accepts only numerical values.

Handling Unit Weight UOM

Select the Mother Piece Handling Unit Weight UOM from the drop-down list. The values available for selection are:
• Pounds (LB)
• Kilograms (KG)
Note: 'Pounds (LB)' is selected by default.

FOC Account Number

Enter the FOC Account Number for the DHL Global BBX shipment. The Maximum number of characters allow for the value of this field is 12.

Mother Shipment Service

From the drop-down, select the Mother shipment service. The values available for selection are:
• Express Worldwide
• Economy Select
Note: 'Express Worldwide' is selected by default.

Note:

Click SAVE at the bottom of the screen to save the changes or click CANCEL to cancel any changes.

Limitations to DHL XML-PI validation of Ship request

You need to take the following operational considerations into account when setting up the DHL XML-PI Web service with a DHL Global carrier.
With the current DHL XML-PI workflow, when Parcel processes a DHL Global shipment, two separate transactions are sent to the XML-PI Web service: A Compatibility and Quote request and a Shipment request. Due to the potential performance degradation inherent in processing two separate requests, Parcel provides the "Suppress Capability and Quote on Ship" option enabling you to switch off the Compatibility and Quote request. Although selecting this option should improve overall performance, this approach has the following limitations:

  • Only a rate for the base shipment and fuel surcharge is returned. No rates for Value Added Services are available.

  • There is no Service or Value Added Service validation for the origin/destination. Therefore, it is the shipper's responsibility to know what services and Value Added Services are appropriate for specific shipments.

  • For some origins that do not currently use DHL Global Product Codes in their operations, no Local Product Codes are returned. This limitation can cause DHL operational issues. Therefore, e2open, LLC. recommends that customers check with their local DHL business Unit to determine if this will cause issues before selecting the "Suppress Capability and Quote on Ship" option.

If you leave the "Suppress Capability and Quote" option unselected, Parcel performs the following operations:

  • If no special service is included, Parcel performs both a Compatibility and Quote request plus a shipment validation, and XML-PI returns a rate for the shipment and for Value Added Services that are configured for the customer's account.

  • If a special service is included, Parcel performs two Capability and Quote requests.

Additionally, the XML-Pi Web service does not support a Close or Voiding for shipments. For DHL Global shipments, Parcel performs an internal Void but you must also physically discard the label that was generated for the shipment. If this procedure is followed, you are not charged for the shipment.

Label Tab

Use the Label tab on the DHL Global Account Defaults screen to enter label settings for this DHL Global account.

Template Directory

Type the directory path where DHL Global label templates reside on the Parcel server.

API Printer Name

Type the name the default printer used to print labels when using API requests.

Print Reference Number on Label

From the drop-down list, select the reference number to upload to the DHL XML-PI Web service and print on the label. Possible values are as follows:

  • Reference 1

  • Reference 2

  • Reference 3

  • Reference 4

  • Reference 5

    Note: These reference numbers correspond to Reference1-Reference5 in the lower left corner of
    the Warehouse screen. By default, Parcel prints Reference 1 on the label.

Suppress Label

To suppress label printing with a SHIP API request, select (check) this check box.
Note: This check box is not selected by default.

Zebra Print Speed

Accept the default (8) or set the print speed for labels printed with a Zebra printer. Valid values (from the Zebra Printing Language manual) are as follows:

  • A or 2 – 2 in./sec.

  • B or 3 – 3 in./sec.

  • C or 4 – 4 in./sec.

  • 5 – 5 in./sec.

  • D or 6 – 6 in./sec.

  • E or 8 – 8 in./sec.

Hide Account No. on Label

To hide the Account No. on the label, select (check) this check box.
Note: This check box is not selected by default.

Label Template Type
(Applicable only for US origin)

From the drop-down list, select the Label Template type returns from the server. Possible values are as follows:

  • 4 X 8_thermal

  • 4 X 6_thermal

Note:
Click SAVE at the bottom of the screen to save the changes or click CANCEL to cancel any changes.

System Tab

Use the System tab on the DHL Global Account Defaults screen to enter the DHL XML-PI settings for this DHL Global account.
DHL XML-PI section

Web Url

Type or paste the URL for the DHL XML-PI Web service. The default is: http://xmlshippingtest.dhl-usa.com/XMLShippingServlet

User ID

Type the User ID for the DHL XML-PI Web service.

Password

Type the Password for the DHL XML-PI Web service.

Request Retry

Type the number of retries if connection to the DHL XML-PI Web service fails.

BBX Hostname

Displays the BBX Hostname for the DHL XML-PI identifier request.
Note: Default value is Test URL and user needs to configure Production URL.

BBX Page Path

Displays the BBX Page Path for the DHL XML-PI identifier request.
Note: Default value is Test Path and user needs to configure Production Path.

Defaults

Address Tab

Use the Address tab on the DHL Global Defaults page to enter the default "Ship From" or "distribution center" address for this DHL Global account.

Name

Type the company name for the "Ship From" address.

Attention

Type the name of the person responsible for shipments.

Address 1

Type the "Ship From" street address.

Address 2

Type any additional street address information for the "Ship From" address such as suite or floor.

Address 3

Type any additional street address information for the "Ship From" address such as suite or floor.

City

Type the "Ship From" city.

State/Province

Type the "Ship From" state or province.

Postal Code

Type the "Ship From" postal code.

Country

From the drop-down list, select the "Ship From" country name.

Phone

Type the "Ship From" phone number.

Note: For addresses, Parcel supports the International character set.