DHL Shipping for Magento® 2 · 2019. 4. 2. · DHL Business Customer Shipping...

26
DHL Shipping for Magento® 2 The module DHL Shipping for Magento® 2 enables merchants with a DHL account to create shipments and retrieve shipping labels. The module supports the following webservices: • DHL Paket Business Customer Shipping (Geschäftskundenversand) API • DHL eCommerce Global Shipping API Which of these webservices is actually used depends on the shipping origin country. Last updated: 2019-03-12 1/27

Transcript of DHL Shipping for Magento® 2 · 2019. 4. 2. · DHL Business Customer Shipping...

  • DHL Shipping for Magento® 2The module DHL Shipping for Magento® 2 enables merchants with a DHL account to create shipmentsand retrieve shipping labels.

    The module supports the following webservices:

    • DHL Paket Business Customer Shipping (Geschäftskundenversand) API

    • DHL eCommerce Global Shipping API

    Which of these webservices is actually used depends on the shipping origin country.

    Last updated: 2019-03-12 1/27

  • End user documentation1 Requirements 4

    1.1 Magento® 2 4

    1.2 PHP 4

    2 Hints for using the module 5

    2.1 Shipping origin 5

    2.2 Currency 5

    2.3 Data protection 5

    3 Installation and configuration 6

    3.1 Installation 6

    3.2 Module configuration 6

    3.2.1 General Settings 7

    3.2.2 Account Data 8

    3.2.3 General Shipping Settings 8

    3.2.4 Additional Services In Checkout 9

    3.2.5 Cash On Delivery Settings 10

    3.2.6 Default shipping label creation settings 10

    3.2.7 Additional Shipping Services 11

    3.2.8 eCommerce Global API Shipping Settings 11

    3.2.9 Automatic Shipping Label Creation 11

    3.2.10 Additional Product Attributes 12

    3.3 Booking additional services 12

    3.4 Additional costs for services 12

    4 Workflow and features 13

    4.1 Creating an order 13

    4.1.1 Checkout 13

    4.1.2 Admin Order 13

    4.1.3 DHL Delivery Addresses (Packing Stations, Post Offices) 13

    4.2 Creating a shipment 14

    4.2.1 National shipments 14

    4.2.2 International shipments 15

    4.2.3 Service selection 16

    4.2.4 Mass action 17

    4.3 Printing a shipping label 18

    4.4 Printing a return slip 19

    4.5 Canceling a shipment 20

    Last updated: 2019-03-12 2/27

  • 4.6 Automatic shipment creation 21

    4.7 Shipment Overview 22

    4.8 Troubleshooting 23

    4.8.1 Shipment creation 23

    4.8.2 Additional DHL services 24

    5 Uninstalling the module 25

    6 Technical support 26

    Last updated: 2019-03-12 3/27

  • 1 RequirementsThe following requirements must be met for a smooth operation of the module.

    1.1 Magento® 2The following Magento® 2 versions are supported:

    • Community Edition 2.1.4+

    • Community Edition 2.2.4+

    • Community Edition 2.3.0+

    1.2 PHPThese PHP versions are supported:

    • PHP 5.6.5+

    • PHP 7.0.2

    • PHP 7.0.4

    • PHP 7.0.6+

    • PHP 7.1.0+

    • PHP 7.2.0+

    To connect to the API (webservice), the PHP SOAP extension must be installed and enabled on the webserver.

    Further information can also be found in these files inside the module package / repository:

    • README.md

    • composer.json

    If in doubt: the version information in the file composer.json supersedes any other information.

    Repository

    The public Git repository can be found here:

    https://github.com/netresearch/dhl-module-shipping-m2/

    README.md with installation instructions:

    https://github.com/netresearch/dhl-module-shipping-m2/blob/master/README.md

    Last updated: 2019-03-12 4/27

    https://github.com/netresearch/dhl-module-shipping-m2/https://github.com/netresearch/dhl-module-shipping-m2/blob/master/README.md

  • 2 Hints for using the module

    2.1 Shipping originThe DHL webservices (APIs) only support the following origin countries:

    DHL Business Customer Shipping (Geschäftskundenversand) API

    • Germany

    • Austria

    eCommerce Global Label API

    • Australia

    • Canada

    • Chile

    • China

    • Hongkong

    • India

    • Japan

    • Malaysia

    • New Zealand

    • Singapore

    • Thailand

    • USA

    • Vietnam

    The shop's shipping origin address must be located in one of the above countries, and it must be enteredcompletely into the Module configuration.

    Please also note the information in section International shipments.

    2.2 CurrencyThe base currency is assumed to be the official currency of the sender country which is set in theMagento® configuration. There is no automated conversion between currencies.

    2.3 Data protectionThe module transmits personal data to DHL which are needed to process the shipment (names,addresses, phone numbers, email addresses, etc.). The amount of data depends on the Moduleconfiguration as well as the booked Additional Services In Checkout.

    The merchant must obtain consent from the customer to process the data, e.g. via the shop's terms andconditions and / or an agreement in the checkout (Magento® 2 Checkout Agreements).

    Last updated: 2019-03-12 5/27

  • 3 Installation and configuration

    3.1 InstallationInstall the module according to the instructions from the file README.md (see section Requirements).

    We recommend installing the module with Composer. It is very important to follow all steps exactly. Do notskip any steps.

    Any database changes during installation are also shown in the file README.md.

    Additional module for DHL label status required

    Since version 0.10.0 you need to install the additional module dhl/module-label-status to see theShipment Overview. During installation with Composer, this additional module will be suggested,but it is not installed by default.

    The additional module can only be installed in Magento® 2.2.x or 2.3.x. Magento® 2.1.x is notsupported. The DHL label status will not be shown in the order list.

    3.2 Module configurationThere are three configuration sections which are relevant for creating shipments:

    Stores → Configuration → General → General → Store-InformationStores → Configuration → Sales → Shipping Settings → OriginStores → Configuration → Sales → Shipping Methods → DHL Shipping

    Make sure that the following required fields in the sections Store Information and Origin are filled incompletely:

    • Store Information

    • Store Name

    • Store Contact Telephone

    • Origin

    • Country

    • Region / State

    • ZIP / Postal Code

    • City

    • Street Address

    If you are shipping from multiple countries, you can configure different sender addresses on Website orStore level.

    Last updated: 2019-03-12 6/27

    https://github.com/netresearch/dhl-module-label-status

  • Note

    The section Shipping Methods → DHL is a core part of Magento® 2 which connects to thewebservice of DHL USA only. These settings are not relevant for the DHL Shipping module.

    3.2.1 General SettingsThe dropdown in the configuration section General Settings shows which API connection is beingconfigured.

    • DHL Business Customer Shipping (DE, AT), or

    • DHL eCommerce Global Label API

    This field is pre-selected according to the current Shipping origin. Depending on the selection, differentconfiguration fields are shown below.

    Note about the API

    The actual API connection to be used depends on the Shipping origin and is selected automaticallyduring transmission to DHL. The aforementioned dropdown only makes the configuration fieldsvisible. It does not select which API will actually be used.

    You can choose if you want to run the module in Sandbox Mode to test the integration, or use theproduction mode.

    If the logging is enabled in the DHL module, the webservice messages will be recorded in the log filevar/log/debug.log. There will be no separate log file for the DHL module. Also note these hints aboutlogging.

    You can choose between three log levels:

    • Error: Records communication errors between the shop and the DHL webservice.

    • Warning: Records communication errors and also errors due to invalid shipment data (e.g. addressvalidation failed, invalid services selected).

    • Debug: Record all messages, including downloaded label raw data in the log.

    Make sure to archive or rotate the log files regularly. The log level Debug should only be set whileresolving problems, because it will result in very large log files over time.

    Last updated: 2019-03-12 7/27

    http://dhl.support.netresearch.de/support/solutions/articles/12000051181http://dhl.support.netresearch.de/support/solutions/articles/12000051181

  • 3.2.2 Account DataThis configuration section holds your access credentials for the DHL webservice which are required forproduction mode. You will get this information directly from DHL.

    When using DHL Business Customer Shipping (Geschäftskundenversand) in sandbox mode, noadditional input is necessary.

    When using DHL Business Customer Shipping (Geschäftskundenversand) in production, enter thefollowing data:

    • Username (German: Benutzername)

    • Signature (German: Passwort)

    • EKP (DHL account number, 10 digits)

    • Participation numbers (German: Teilnahmenummern, two digits per field)

    Configuration of billing numbers

    A detailled tutorial for configuring the billing numbers, DHL products, and participation numberscan be found in this article in the Knowledge Base.

    When using the eCommerce Global Label API, enter the following data:

    • Pickup Account Number (5 to 10 digits)

    • Customer Prefix (up to 5 digits)

    • Distribution Center (6 digits)

    • Client ID

    • Client Secret

    3.2.3 General Shipping Settings

    • Shipping Methods for DHL Shipping: Select which shipping methods should be used for calculatingshipping costs in the checkout. Only shipping methods that are selected here will be handled by theDHL extension when creating shipments.

    Last updated: 2019-03-12 8/27

    http://dhl.support.netresearch.de/support/solutions/articles/12000024659

  • 3.2.4 Additional Services In CheckoutIn the configuration section Additional Services In Checkout you can choose which additional DHLservices you want to offer to your customers.

    Please also note the information about Booking additional services and Additional costs for services.

    • Enable Preferred Location: The customer can state an alternative location where the shipment canbe placed in case they are not at home.

    • Enable Preferred Neighbor: The customer can state an alternative address in the neighborhood forthe shipment in case they are not at home.

    • Enable Parcel Announcement: The customer can choose to be notified via email about the status ofthe shipment. The customer's email address will be transmitted to DHL for this service (note thesection Data protection). Select one of the following options:

    • Yes:The customer decides in the checkout if the service should be booked.

    • No: No option is shown in the checkout. The service will not be booked.

    • Enable Preferred Day: The customer can choose a specific day on which the shipment should arrive.The available days are displayed dynamically, depending on the recipient's address and yourconfigured drop-off days.

    • Enable Preferred Time: The customer can choose a time frame within which the shipment shouldarrive. The available times are displayed dynamically, depending on the recipient's address.

    • Service charge for Preferred day / time: This amount will be added to the shipping cost if thecorresponding service is used. Use a decimal point, not comma. The gross amount must be enteredhere (incl. VAT). If you want to offer the service for free, enter 0.

    • Preferred day / time handling fee text: This text will be displayed to the customer in the checkout toexplain the handling fee. You can use the placeholder $1 in the text which will be substituted withconfigured handling fee and currency in the checkout.

    • Cut-off time: This sets the time up to which new orders will be dispatched by you on the same day.Orders placed after the cut-off time will not be dispatched by you on the same day. This affects thePreferred Days available to customers

    • Days excluded from drop-off: Select the days on which you do not hand over shipments to DHL. Thisaffects the Preferred Days available to customers.

    • Service charge for preferred day and time combined: This amount will be added to the shipping costif both services are booked. Use a decimal point, not comma. The gross amount must be enteredhere (incl. VAT). If you want to offer the services combination for free, enter 0.

    • Combined service charge text: This text will be displayed to the customer in the checkout to explainthe combined handling fee. You can use the placeholder $1 in the text which will show theadditional handling fee and currency in the checkout.

    Last updated: 2019-03-12 9/27

  • 3.2.5 Cash On Delivery Settings

    • Cash On Delivery payment methods: Select which payment methods should be treated as Cash OnDelivery (COD) payment methods. Based on this, the COD charge will be transmitted to the DHLwebservice and Cash On Delivery labels are created. If COD is not available, these paymentmethods will be hidden in the checkout.

    • Configure the bank account to be used for Cash On Delivery (COD) shipments with DHL. The CashOn Delivery amount from the customer will be transferred to this bank account by DHL.

    Please note that you might also have to store the bank data in your DHL account. Usually, this canbe done through the DHL Business Customer Portal (Geschäftskundenportal).

    When using the eCommerce Global Label API, the service Cash On Delivery is not available.

    3.2.6 Default shipping label creation settingsIn this section you can configure the default settings for shipments.

    Depending on the selected API (DHL Business Customer Shipping or eCommerce Global Label API)different options are displayed.

    • Default product: Shows the DHL product which will be used by default for creating shipments. Theavailable products are choosen automatically depending on the configured shipping origin. Pleasenote the information in section Module configuration regarding the sender (origin) address.

    • Default Terms of Trade: Select the default terms of trade for customs handling.

    • Default Place of Commital: Select the default place of commitial for customs handling.

    • Default Additional Fee: Additional fee for customs handling.

    • Default Export Content Type: Content type of the shipment for customs handling.

    The customs information can also be set via Additional Product Attributes, see also the sectionInternational shipments.

    Last updated: 2019-03-12 10/27

  • 3.2.7 Additional Shipping ServicesThese settings apply only to bulk shipments (mass action) and shipments automatically created viaCronjob.

    • Use Print only if codeable service: If this is enabled, only shipments with 100 % valid addresses willbe accepted by DHL. Otherwise, DHL will reject the shipment and issue an error message. If thisoption is disabled, DHL will attempt to correct an invalid address automatically, which results in anadditional charge (Nachkodierungsentgelt). If the address cannot be corrected, DHL will still rejectthe shipment.

    • Use Visual Check of Age service: Select if the service for age verification should be booked, andwhat the minimum age is. Options:

    • No: The service will not be booked.

    • A16: Minimum age 16 years.

    • A18: Minimum age 18 years.

    • Use Return Shipment service: Select if a return label should be created together with the shippinglabel. See also Printing a return slip.

    • Use Additional Insurance service: Select if an additional insurance should be booked for theshipment.

    • Use Bulky Goods service: Select if the service for bulky goods (bulk freight) should be booked.

    3.2.8 eCommerce Global API Shipping SettingsIn this section you can configure the label size, page size, and layout.

    3.2.9 Automatic Shipping Label CreationThe section Automatic Shipment Creation lets you choose if shipments should be created and packagelabels retrieved automatically.

    You can also configure which order status an order must have to be processed automatically. You canuse this to exclude specific orders from being processed automatically.

    Also, you can choose whether or not an email will be be sent to the customer when the shipment hasbeen created. This refers to the Magento® shipment confirmation email, not the parcel announcementfrom DHL.

    Note

    Automated shipment creation requires working Magento® 2 Cronjobs.

    Last updated: 2019-03-12 11/27

  • 3.2.10 Additional Product AttributesThe module introduces the new product attributes DHL Export Description and Tariff number which canbe used for international shipments.

    These atrributes allow storing the customs information in the system, so the data doesn't have to beentered manually for every shipment.

    Please note the maximum length of:

    • 50 characters for DHL Export Description

    • 10 characters for Tariff Number

    Also note the section International shipments.

    3.3 Booking additional servicesThe available services as well as preferred days and preferred times depend on the shipping address andcountry of the customer. The DHL Parcel Management API is used for this during the checkout process.Unusable services will be hidden from the checkout automatically.

    If the order contains articles which are not in stock, it will not be possible to book Preferred Day.

    The services Preferred location and Preferred neighbor can not be booked together.

    3.4 Additional costs for servicesThe services Preferred Day and Preferred Time are enabled by default! Therefore the standard DHLhandling fees will be added to your shipping cost every time a customer selects one of these services.

    When using the shipping method Free Shipping, the additional handling fees will always be ignored!

    If you want to use the shipping method Table Rates and set a threshold for free shipping, we recommendsetting up a Shopping Cart Price Rule for this. By using this shipping method the additional fees for DHLservices will be included.

    Last updated: 2019-03-12 12/27

  • 4 Workflow and features

    4.1 Creating an orderThe following section describes how the DHL extension integrates itself into the order process.

    4.1.1 CheckoutIn the Module configuration the shipping methods have been selected for which DHL shipments andlabels should be created. If the customer now selects one of those shipping methods in the checkout, theshipment can later be processed by DHL.

    In the checkout step Payment information the Cash On Delivery payment methods will be disabled if CashOn Delivery is not available for the selected delivery address (see Cash On Delivery payment methods forDHL Shipping).

    4.1.2 Admin OrderWhen creating orders via the Admin Panel, the Cash On Delivery payment methods will be disabled ifCash On Delivery is not available for the delivery address (same behaviour as in the checkout).

    4.1.3 DHL Delivery Addresses (Packing Stations, Post Offices)The module offers limited support for DHL delivery addresses in the checkout:

    • The format Packstation 123 in the field Street will be recognized.

    • The format Postfiliale 123 in the field Street will be recognized.

    • A numerical value in the field Company will be recognized as Post Number.

    Note

    For successful transmission to DHL, the above information must be entered in the correct format.

    See also Shipping to post offices and Shipping to Packstations.

    Last updated: 2019-03-12 13/27

    https://www.dhl.de/en/privatkunden/pakete-empfangen/an-einem-abholort-empfangen/filiale-empfang.htmlhttps://www.dhl.de/en/privatkunden/pakete-empfangen/an-einem-abholort-empfangen/packstation-empfang.html

  • 4.2 Creating a shipmentThe following section explains how to create a shipment for an order and how to retrieve the shippinglabel.

    4.2.1 National shipmentsIn the Admin Panel, select an order with a shipping method linked to DHL (see Module configuration,section Shipping Methods for DHL Shipping).

    Then click the button Ship on the top of the page.

    You will get to the page New shipment for order.

    Activate the checkbox Create shipping label and click the button Submit Shipment....

    Now a popup window for selecting the shipping items in the package will be opened. The default productfrom the section General Shipping Settings will be pre-selected.

    Click the button Add products, select all products, and confirm by clicking Add selected product(s) topackage.

    The package dimensions are optional. Make sure the weight is correct.

    The button OK in the popup window is now enabled. When clicking it, the shipment will be transmitted toDHL and (if the transmission was successful) a shipping label will be retrieved.

    If there was an error, the message from the DHL webservice will be displayed at the top of the popup. Youmight have to scroll up inside the popup to see the error message.

    The incorrect data can now be corrected, see also Troubleshooting.

    Last updated: 2019-03-12 14/27

  • 4.2.2 International shipmentsFor international shipments, information for the customs declaration might be needed.

    In particular:

    • When using DHL Business Customer Shipping (Geschäftskundenversand) for destinations outside ofthe EU, at least the customs tariff number and the export content type of the shipment are needed.

    • When using the eCommerce Global Label API for destinations outside of the origin country, at leastthe Terms Of Trade (Incoterms), the Customs Tariff Number (HS Code), and the product exportdescription are needed.

    The export description and the tariff number are taken from the respective product attributes, seealso Additional Product Attributes. If the export description is not set, the product name will be usedinstead.

    The default values (e.g. Terms Of Trade) can be set in the module configuration.

    Alternatively, you can enter the information by hand in the popup when creating the shipment, e.g. forspecial cases with different, non-default information.

    Everything else is the same as described in the section National shipments.

    About configurable products

    For configurable products, the aforementioned attributes must be set directly in the configurableproduct, not in the associated simple products.

    Last updated: 2019-03-12 15/27

  • 4.2.3 Service selectionThe available services for the current delivery address are shown in the packaging popup window.

    The preselection of the services depends on the default values from the general Module configuration.

    Note

    This screenshot is just an example. Other services than the ones shown here may be available.

    Please note that the following inputs are not allowed for Preferred location and Preferred neighbor:

    Invalid special characters

    < > \ ' " " + \n \r

    Invalid data

    • Paketbox

    • Postfach

    • Postfiliale / Postfiliale Direkt / Filiale / Filiale Direkt / Wunschfiliale

    • Paketkasten

    • DHL / Deutsche Post

    • Packstation / P-A-C-K-S-T-A-T-I-O-N / Paketstation / Pack Station / P.A.C.K.S.T.A.T.I.O.N. /Pakcstation / Paackstation / Pakstation / Backstation / Bakstation / P A C K S T A T I O N

    Last updated: 2019-03-12 16/27

  • 4.2.4 Mass actionShipments and labels can also be created using the mass action Create Shipping Labels in the order grid:

    • Sales → Orders → Mass action Create Shipping Labels

    This allows the creation of shipping labels with no further user input

    • for all items contained in the order

    • with the services selected during checkout

    • with the services selected in the Automatic Shipment Creation Module configuration.

    For international shipments, the customs information will be taken from the product attributes and thedefault values in the configuration (see International shipments), if necessary.

    Note

    The dropdown contains two very similar entries: Print shipping labels and Create shipping labels.Make sure to use the correct entry!

    The function Print shipping labels only allows printing existing shipping labels.

    Last updated: 2019-03-12 17/27

  • 4.3 Printing a shipping labelThe successfully retrieved shipping labels can be opened in several locations of the Admin Panel:

    • Sales → Orders → Mass action Print shipping labels

    • Sales → Shipments → Mass action Print shipping labels

    • Detail page of a shipment → Button Print shipping label

    This does not trigger the transmission to DHL, but only opens the labels again that already exist. Totransmit shipments to DHL, please use the Mass action.

    Note

    If you are using a German locale, the exact names of the German menu entries Bestellungen orLieferscheine can differ slightly, depending on the installed Language Pack (e.g. Aufträge orLieferungen). However, this is not important for the usage.

    Last updated: 2019-03-12 18/27

  • 4.4 Printing a return slipWhen shipping within Germany, within Austria, or from Austria to Germany, it is possible to create a returnslip together with the shipping label.

    Use the option Retoure slip when requesting a label in the packaging popup.

    To book this service, make sure the participation numbers for returns are properly configured:

    • Retoure DHL Paket (DE → DE)

    • Retoure DHL Paket Austria (AT → AT)

    • Retoure DHL Paket Connect (AT → DE)

    Last updated: 2019-03-12 19/27

  • 4.5 Canceling a shipmentAs long as a shipment has not been manifested, it can be canceled at DHL.

    You can click the link Delete in the box Shipping and tracking information next to the tracking number.

    When using DHL Business Customer Shipping, this will also cancel the shipment at DHL.

    Note for eCommerce Global Label API

    If you are using the eCommerce Global Label API the above workflow will not cancel the shipmentat DHL! It only deletes the tracking number in Magento®.

    To cancel an eCommerce Global Label API shipment, please use the usual way via the DHLwebsite (e.g. the DHL Business Customer Portal).

    If you only delete the tracking number in Magento® without cancelling the shipment at DHL, youwill be charged by DHL for the shipping cost.

    Last updated: 2019-03-12 20/27

  • 4.6 Automatic shipment creationThe process for creating shipments manually can be too time-consuming or cumbersome for merchantswith a high shipment volume. To make this easier, you can automate the process of creating shipmentsand transmitting them to DHL.

    Enable the automatic shipment creation in the Module configuration and select which services should bebooked by default.

    Note

    The automatic shipment creation requires working Magento® cron jobs.

    Every 15 minutes all orders which are ready for shipping (based on the configuration) will be collected andtransmitted to DHL.

    If the transmission was successful, the label will be stored in Magento® and the Magento® shipments willbe created.

    Error messages will be shown in the order comments.

    Last updated: 2019-03-12 21/27

  • 4.7 Shipment OverviewIn the order grid at Sales → Orders you will find a column DHL Label Status. It displays the current statusof your DHL shipments.

    The symbols have the following meaning:

    • colored DHL logo: The DHL shipment was successfully created

    • grey DHL logo: The DHL shipment was not yet created, or the order was only partially shipped

    • crossed-out DHL logo: There was an error during the last attempt to create a DHL shipment

    Shipments that cannot be processed by DHL Shipping will not display a logo in the DHL Label Statuscolumn.

    You can filter orders by DHL label status using the Filters function above the order grid.

    Note: additional module required

    For this functionality, an additional module must be installed, see section Installation.

    The add-on module cannot be installed in Magento® 2.1.x, therefore this functionality is notsupported.

    Last updated: 2019-03-12 22/27

  • 4.8 Troubleshooting

    4.8.1 Shipment creationDuring the transmission of shipments to DHL, errors can occur. These are often caused by an invalidaddress or an invalid combination of additional services.

    When creating shipments manually, the error message will be directly visible in the popup. You mighthave to scroll up inside the popup to see the message. If the logging is enabled in the ModuleConfiguration, you can also check the shipments in the log files.

    Note

    When using the automatic shipment creation, make sure to regularly check the status of yourorders to prevent the repeated transmission of invalid shipment requests to DHL.

    Erroneous shipment requests can be corrected as follows:

    • In the popup window for selecting the package articles, you can correct invalid information.

    • On the detail page of the order or shipment, you can edit the receiver address and correct any errors.Use the link Edit in the box Shipping address.

    On this page, you can edit the address fields in the upper part, and the special fields for DHLshipping in the lower part:

    • Street name (without house number)

    • House number (separately)

    • Address addition

    Last updated: 2019-03-12 23/27

  • Afterwards, save the address. If the error has been corrected, you can retry Creating a shipment.

    If a shipment has already been transmitted successfully via the webservice, but you want to makechanges afterwards, please cancel the shipment first as described in the section Canceling a shipment.Then click Create shipping label... inside the same box Shipping and tracking information. From here on,the process is the same as described in Creating a shipment.

    4.8.2 Additional DHL servicesIn case of problems with Additional Services In Checkout (e.g. Preferred Day), error messages will bewritten to a separate log file. See the notes in chapter General settings. The log contains information forfurther troubleshooting.

    Also note the hints about Booking additional services.

    Last updated: 2019-03-12 24/27

  • 5 Uninstalling the moduleTo uninstall the module, follow these steps described in the file README.md from the module package.

    The README.md is linked in the section Requirements.

    Last updated: 2019-03-12 25/27

  • 6 Technical supportIn case of questions or problems, please have a look at the Support Portal (FAQ) first:http://dhl.support.netresearch.de/

    If the problem cannot be resolved, you can contact the support team via the Support Portal or by sendingan email to [email protected]

    Last updated: 2019-03-12 26/27

    http://dhl.support.netresearch.de/mailto:[email protected]

    1   Requirements1.1   Magento® 21.2   PHP

    2   Hints for using the module2.1   Shipping origin2.2   Currency2.3   Data protection

    3   Installation and configuration3.1   Installation3.2   Module configuration3.2.1   General Settings3.2.2   Account Data3.2.3   General Shipping Settings3.2.4   Additional Services In Checkout3.2.5   Cash On Delivery Settings3.2.6   Default shipping label creation settings3.2.7   Additional Shipping Services3.2.8   eCommerce Global API Shipping Settings3.2.9   Automatic Shipping Label Creation3.2.10   Additional Product Attributes

    3.3   Booking additional services3.4   Additional costs for services

    4   Workflow and features4.1   Creating an order4.1.1   Checkout4.1.2   Admin Order4.1.3   DHL Delivery Addresses (Packing Stations, Post Offices)

    4.2   Creating a shipment4.2.1   National shipments4.2.2   International shipments4.2.3   Service selection4.2.4   Mass action

    4.3   Printing a shipping label4.4   Printing a return slip4.5   Canceling a shipment4.6   Automatic shipment creation4.7   Shipment Overview4.8   Troubleshooting4.8.1   Shipment creation4.8.2   Additional DHL services

    5   Uninstalling the module6   Technical support