DHL Paket Shipping Carrier Extension

The DHL Paket extension for Magento® 2 integrates the DHL Business Customer Shipping
API into the order processing workflow.

Description

This extension enables merchants to request and cancel shipping labels for incoming orders
via the DHL Business Customer Shipping API (DHL Geschäftskundenversand-API).

Requirements

• PHP >= 8.3

Compatibility

• Magento >= 2.4.8

Installation Instructions

Install sources:

composer require dhl/module-carrier-paket

Enable module:

./bin/magento module:enable Dhl_Paket
./bin/magento setup:upgrade

Flush cache and compile:

./bin/magento cache:flush
./bin/magento setup:di:compile

Uninstallation

To unregister the carrier module from the application, run the following command:

./bin/magento module:uninstall --remove-data Dhl_Paket
composer update

This will automatically remove source files, clean up the database, update package dependencies.

Support

In case of questions or problems, please have a look at the
Support Portal (FAQ) first.

If the issue cannot be resolved, you can contact the support team via the
Support Portal or by sending an email
to [email protected].

License

OSL - Open Software Licence 3.0

Copyright

(c) 2023 DHL Paket GmbH

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog
and this project adheres to Semantic Versioning.

3.5.0

Magento 2.4.9 compatibility release

Added

• Support for Magento 2.4.9
• Support for PHP 8.5

3.4.3

Added

• NL, CY, CZ, EE, LT, LV as allowed country for Closest Droppoint (CDP) service.

Changed

• Remove HU as allowed country for Closest Droppoint (CDP) service.

3.4.2

Changed

• Make Postal Delivery Duty Paid (PDDP) service mandatory for USA shipments under $800.

3.4.1

Added

• France as allowed country for Closest Droppoint (CDP) service.

3.4.0

Magento 2.4.8 compatibility release + GoGreen Plus support

Added

• Support for Magento 2.4.8
• Support for PHP 8.4
• GoGreen Plus service support for climate-neutral shipping
• GoGreen Plus service support for climate-neutral return shipments

Changed

• Upgrade to Monolog 3.x logging framework
• Upgrade to PHPUnit 10 testing framework
• Improved error handling for Magento 2.4.8 compatibility

Removed

• Support for PHP 8.2

3.3.0

Added

• Customs Input for MRN (Master Reference Number) in Packaging Popup.

3.2.0

Deutsche Post Warenpost becomes DHL Kleinpaket

Added

• support for DHL Kleinpaket

Removed

• support for Deutsche Post Warenpost

3.1.2

Changed

• Sandbox Credentials

3.1.0

Fixed

• Fixed parameter ordering issue that caused shipping label creation for post office delivery locations to fail schema validation.

3.0.0

Magento 2.4.7 compatibility release

Added

• Support for Magento 2.4.7

Changed

• Replace Zend_Measurement with Magento Framework Measurement
• Use escaper instead of block for escaping in templates
• replace sdk-api-bcs with the new sdk-api-parcel-de

Removed

• Support for PHP 7.x
• Support for PHP 8.1

2.9.0

Added

• Book Postal Delivery Duty Paid (PDDP) service with deliveries to CH destinations.

Fixed

• Mask billing numbers and API key in web service logs.

2.8.0

Added

• Book Signed for by recipient (Empfängerunterschrift) service.
• Book Postal Delivery Duty Paid (PDDP) service.
• Book Closest Droppoint (CDP) service.
• Confgure label size in module configuration.
• Select DHL business customer portal group profile via module configuration.

Changed

• Switch DHL shipping API from SOAP to REST. SDK classes are no longer injected via DI.

Removed

• The printOnlyIfCodeable flag can no longer be set for individual packages.
  The module configuration setting ("Shipment Defaults") always applies.

Fixed

• Add DE translation for non-delivery instruction options.
• Type-cast store ID to integer, reported via #11.

2.7.0

Added

• Display additional locker location information on the map in checkout.
• Select endorsement (abandon, return) for international, undeliverable shipments.
• Select Bulky Goods service with DHL Paket International shipments.
• Select Named Person Only service with DHL Paket National shipments.
• Select No Neighbor Delivery service with DHL Paket National shipments.

Changed

• The Print Receiver Contact Details configuration setting is replaced by a
  Send Receiver Phone Number setting that applies to cross-border shipments only.

Fixed

• Improve handling of apartment addresses when splitting the recipient street.
• Prevent broken styling in module configuration, reported via #50.

2.6.2

Fixed

• Apply min length validator to post number input in checkout.

2.6.1

Fixed

• Fix typing error in checkout service box (DE).

2.6.0

Magento 2.4.4 compatibility release

Added

• Support for Magento 2.4.4

Removed

• Support for PHP 7.1

2.5.0

Added

• Select and book delivery to DHL Parcel Shops.
• Set or change the DHL Paket Parcel Outlet Routing email notification address individually per shipment.
• Reset service fee configuration setting to module default ("use system value").
• Set shipping product name as track title.

Changed

• Configure checkout shipping method name in module configuration.

2.4.0

Added

• Warenpost International shipping product.

2.3.0

Added

• Europaket shipping product for EU countries.

2.2.1

Changed

• Establish compatibility with shipping core 2.4.

2.2.0

Magento 2.4.3 compatibility release

Added

• Support for Magento 2.4.3

2.1.0

Added

• Offer Premium service for cross-border shipments.
• Print a logo image on the shipment label by using a shipper address from the DHL business customer portal address book.

2.0.1

Fixed

• Update version constraint for the netresearch/module-shipping-core package.

2.0.0

Changed

• Replace shipping core package dependency.

Fixed

• Include house number addition for Baden-Württemberg shipping addresses.

1.4.2

Added

• Print receiver phone number on the shipping label if enabled via module configuration.

Changed

• Error message on API communication exceptions is updated as suggested in issue #18.

1.4.1

Bugfix Release

Fixed

• Update link to the DHL track & trace portal.
• Include exponent number on the shipping label for Italian shipping addresses.

1.4.0

Customs Regulations Release

Added

• Transmit the sender's/addressee's customs reference number with label requests.

Changed

• Add postal charges to label requests with customs declaration.
• Mark package dimensions required for label requests with customs declaration.
• Mark item description and postal charges required for label requests with customs declaration.

Fixed

• Round cash on delivery amount if value has more than two digits after the decimal point.

1.3.0

Added

• Possibility to configure an alternative notification email for parcel outlet routing service.
• Text block in module configuration advertising Deutsche Post Direkt services.

Changed

• Rename Wunschpaket (Preferred Delivery) services to align with official DHL naming.

Removed

• Contact person name no longer printed on shipping label.

1.2.0

Magento 2.4 compatibility release

Added

• Support for Magento 2.4

Removed

• Support for Magento 2.2

Fixed

• Prevent Parcel Management API calls if not required.
• Prevent attempts to bulk create Warenpost labels for orders with Cash On Delivery payment.
• Allow letters in Participation Numbers configuration.
• Display correct version number in module configuration info box.

1.1.0

Deutsche Post Warenpost release

Added

• Support Warenpost
  shipping product (merchandise shipment)

Changed

• Switch to Unified Location Finder API
  for displaying parcel stations/post offices in checkout
• Improve translations

Fixed

• Use correct log file for shipment tracking web service communication
• Do not offer Visual Check of Age service for cross-border shipments

1.0.0

Initial release