DHL shipping method

Description

This screen enables you to edit the DHL shipping method options.
Shipping methods will be filtered on checkout based on the zone you set for them, if any.
Then, they will be displayed to the user for him to choose which shipping method he prefers for his order.

Toolbar

ship method Toolbar

 

  • Save & Close : Save the shipping method options and return to the shipping methods Management screen.
  • Save : Apply the modifications to the shipping method and stay on the same screen.
  • Cancel : Return to the previous screen without saving the modifications.

Main Information

If you use one of our commercial versions, you will be able to enter the name and description in different languages.
This feature can be activated in the configuration page, in the display tab.
If you don't enter something for a translation, it will just use the default information in the Main information tab instead.
After you click on save or apply an additional publish icon will appear next to the fields where you entered something in the languages tabs so that you can easily enable or disable them.

Generic configuration

  • Published: Indicate if the method is published or not.
  • Images: You can click on the edit icon to select one or several images to display next to the name of the shipping method during the checkout process.
    Those images are stored in the folder media/com_hikashop/images/shipping so you can easily add more of them by uploading your images to this folder via FTP.
  • Price: Specify a base shipping price which will be added to the DHL shipping estimation.
  • Percentage: Specific a percentage which will be based on the subtotal amount of the cart and added to the DHL shipping estimation.
  • Tax category: Indicate the tax category for the shipping method
  • Use price per product: Indicate if you want to add shipping fees for specific products.
  • Include virtual product price: Indicate if virtual products should be included for the processing (it will affect percentage price and restrictions).
  • Override shipping address: You can override the shipping address. That option is not recommanded for dynamic shipping methods like that one.
  • Override tax zone: You can override the tax zone if the customer select that shipping method.

Specific configuration

  • Environment: Define your DHL shipping environment among Production or Test. You might want to first use the test environment to make sure everything's working before switching to the production environment. Note that in the environment, the tracking link won't point to the corresponding package.
  • API's Username: Your DHL API Username.
  • API's Password: Your DHL API password.
  • Account Number: Your account number reference.
  • Address elements :
    Here, you can define your address elements as seller which will correspond to the starting point to calculate the distances and therefore the prices of DHL services.
    • Company
    • Name
    • Address line
    • Complement
    • City
    • Post code
    • Country code (2 letters)
    • Telephone
    • Email address
    Please make sure you fill in everything. Only the complement field is optional.

  • The Registration Number fields identify the sender for customs and regulatory compliance. This includes various registration numbers (such as VAT number or customs IDs), which differ by country and product type. These numbers ensure adherence to local laws and facilitate customs clearance. Using multiple fields provides flexibility to collect necessary details for international transactions.
    • Registration number
    • Registration number type
    • Registration number issuer country code (2 letters)
    • Second registration number
    • Second registration number type
    • Second registration number issuer country code (2 letters)
    • Third registration number
    • Third registration number type
    • Third registration number issuer country code (2 letters)
    • Fourth registration number
    • Fourth registration number type
    • Fourth registration number issuer country code (2 letters)

  • Shipping services
    Select from all the services offered by DHL :
    • Domestic Express
    • Domestic Express before 12:00
    • Domestic Express before 9:00
    • Express Worldwide EU
    • Economy Select EU
    • Express Worldwide DOC
    • Express Worldwide before 12:00 DOC
    • Express Worldwide before 9:00 DOC
    • Express Worldwide NON DOC
    • Express Worldwide before 12:00 NON DOC
    • Express Worldwide before 9:00 NON DOC
    • Express Envelope
    We recommend that you first leave everything checked when first testing as most of these are only available in some cases.
  • Special agreement: Activate this setting if you don't want to filter out the services which needs DHL Express special customer agreement.
  • weight unit: Define the weight unit for all your packages. In the USA, you normally have to select "imperial", and in Europe and the rest of the world "metric".
  • Parcel max weight: You can enter here a custom maximum weight for parcels. Above this threshold, the plugin will pack the products in a separate parcel. If left empty, the plugin will use the default maximum weight: 70kg / 154lb
  • Parcel max length: You can enter here a custom maximum length for parcels. Above this threshold, the plugin will pack the products in a separate parcel. If left empty, the plugin will use the default maximum length: 120cm / 47.2in
  • Parcel max width: You can enter here a custom maximum width for parcels. Above this threshold, the plugin will pack the products in a separate parcel. If left empty, the plugin will use the default maximum width: 80cm / 31.5in
  • Parcel max height: You can enter here a custom maximum height for parcels. Above this threshold, the plugin will pack the products in a separate parcel. If left empty, the plugin will use the default maximum height: 80cm / 31.5in
  • Use max dimensions as parcel dimensions: If this setting is deactivated (default), each parcel of a shipment will have dimensions based on the dimensions of the products in it. If this setting is activated, each parcel of a shipment will have dimensions based on the maximum dimensions filled in above, or the default maximum dimensions.
  • Incoterms: Define responsibilities between buyer and seller for costs, risks, and tasks related to shipping. Learn more about available options here:
    Note : Learn more about Incoterms 2020 Guide.
    By default, this setting is set to "DAP" and that's usually what you want to select here.
  • Signature path: Path to your signature file (image in jpg, jpeg, png). This image will be provided to DHL for the invoice generation for international shipments. The path should be relative to the root folder of your website.
  • Group packages: Select if you want group or not the products in the order in different packages.
  • Show ETA: Choose if you want display the ETA (Estimated Time of Arrival) or not.
  • Weight approximation: You can add here a percentage to the weight of your products.
  • Dimension approximation: You can add here a percentage to the dimensions of your products.
  • Sort shipping services: Define how to sort your DHL rates.
  • Debug: Switch on ("yes") or off ("no") to allow your Hikashop DHL plugin to fill the log file, especially if there is any trouble. The log file is here to be able to see debug data. You can access it via the "payment log file" setting of the HikaShop configuration page.
    This will help in finding where the trouble is with the setup of the plugin if something doesn't work with it.

Restrictions

You can set restrictions on shipping methods. Based on the products in the cart of the user, the system will calculate which shipping methods the customer can choose from.

  • Zone: You can restrict a shipping method to a zone. By clicking on the edit icon, a popup will open enabling you to select a zone. Only customers with a shipping address in the selected zone (or its sub-zones) will see this shipping method. You can remove this limitation by clicking on the delete icon.
  • Warehouse: You can restrict the shipping method to one or more warehouses. You can also choose whether the filter is inclusive ("Only these warehouses") or exclusive ("All except these warehouses") using the radio buttons next to the selector.
  • Minimum price: The shipping method will only be available for orders with a product total above this minimum price.
  • Maximum price: The shipping method will only be available for orders with a product total below this maximum price.
  • Include virtual products price: If you activate this option, the price of virtual goods (products without weight) is taken into account for the maximum and minimum price restrictions above as well as the percentage price calculation. Otherwise, only physical goods (with a weight) are taken into account.
  • With tax: When enabled, the minimum and maximum price restrictions use the product prices including taxes. When disabled, they use the prices excluding taxes. Enabled by default.
  • Minimum quantity: The minimum number of items in the cart for this shipping method to be available. The quantity is calculated as the sum of the quantity of each product in the cart.
  • Maximum quantity: The maximum number of items in the cart for this shipping method to be available.
  • Minimum weight: The minimum total weight of the cart for this shipping method to be available. The weight is calculated as the sum of each product's weight multiplied by its quantity. You can select the weight unit next to this field.
  • Maximum weight: The maximum total weight of the cart for this shipping method to be available.
  • Minimum volume: The minimum total volume of the cart for this shipping method to be available. The volume is calculated from the width, height and length of each product multiplied by its quantity. You can select the volume unit next to this field.
  • Maximum volume: The maximum total volume of the cart for this shipping method to be available.
  • Post code RegEx: A regular expression to match against the customer's postal code. Only customers whose postal code matches the expression will see this shipping method. For example, ^(75|92|93|94) to match postal codes starting with 75, 92, 93, or 94.
  • Prefix: You can restrict the shipping method to only postal codes starting with this prefix.
  • Min. postal code: You can restrict the shipping method to only postal codes within a numeric range, whereby this is the minimum value.
  • Max. postal code: The maximum value of the postal code numeric range.
  • Suffix: You can restrict the shipping method to only postal codes ending with this suffix.

Access Level

You can restrict which Joomla user groups can see and use this shipping method. By default, the shipping method is available to all user groups. Select specific groups to limit access. This is useful if you want to offer specific shipping options only to certain customer groups (e.g. wholesale customers, VIP members).