dhl / module-carrier-update
dhl/module-carrier-update
Optional component to assign incoming orders to the DHL Paket carrier.
DHL Paket Shipping Carrier Update Extension
Companion module to the DHL Paket carrier that allows to rewrite the
shipping method's carrier code when placing an order.
Description
With the introduction of the
Deutsche Post & DHL Shipping module,
a "feature" was removed that turned out to be popular amongst merchants:
the ability to configure multiple shipping methods for processing with DHL Paket.
See GitHub issue #11.
This module brings back the configuration and sales_order_place_after observer
as implemented in the legacy module: The admin user can select a list of
offline shipping methods in the module configuration.
Stores → Configuration → Sales → Post & DHL Shipping → DHL Parcel Germany → Checkout Presentation → Additional Shipping Methods for DHL Paket
Please note that the DHL service box in checkout will not be displayed for these additional shipping methods.
The special methods "DHL Paket" and "DHL Paket Returns" can be ignored in the box
"Shipping Methods for DHL Paket".
When an order is placed with one of the selected methods, then the DHL Paket carrier
gets assigned to the order and further shipping fulfillment will be done with
the DHL Business Customer Shipping API. This solution was suggested in the
issue discussion.
The module applies very basic sanity checks:
- Is the configured shipping origin located in Germany?
- Is the selected shipping method configured for carrier reassignment?
These conditions can be modified or extended via DI configuration, e.g. if only orders
placed in a certain store must be reassigned.
Requirements
- PHP >= 8.3
Compatibility
- Magento >= 2.4.8+
Installation Instructions
Install sources:
composer require dhl/module-carrier-update
Enable module:
./bin/magento module:enable Dhl_CarrierUpdate
Flush cache and compile:
./bin/magento cache:flush
./bin/magento setup:di:compile
Uninstallation
To unregister the module from the application, run the following command:
./bin/magento module:uninstall --remove-data Dhl_CarrierUpdate
composer update
This will automatically remove source files and update package dependencies.
Support
This module does not receive official maintenance or support.
GitHub issues can be created to open discussions with other users of the module.
Contributions (pull requests) will be processed.
License
OSL - Open Software Licence 3.0
Copyright
(c) 2022 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.
1.4.0
Magento 2.4.9 compatibility release
Added
- Support for Magento 2.4.9
- Support for PHP 8.5
1.3.0
Magento 2.4.8 compatibility release
Added
- Support for PHP 8.4
- Support for Magento 2.4.8
- PHPStan static analysis configuration
- Rector code modernization tooling
- Enhanced CI/CD pipeline configuration
1.2.0
Magento 2.4.7 compatibility release
Added
- Support for Magento 2.4.7
Removed
- Support for PHP 7.2
- Support for PHP 8.1
1.1.0
Magento 2.4.4 compatibility release
Added
- Support for Magento 2.4.4
Removed
- Support for PHP 7.1
1.0.1
Fixed
- Allow methods configuration to take an empty value.
1.0.0
Initial release
| Version | Stability | QA Status | Compatibility | Released |
|---|---|---|---|---|
| 1.4.0 | stable | Fail | Magento 2.4.8-2.4.9 Details | 2026-06-03 12:28:12 |
| 1.3.0 | stable | Not tested | Not yet tested Details | 2025-07-02 14:46:03 |
| 1.2.0 | stable | Not tested | Not yet tested Details | 2024-06-27 08:43:58 |
| 1.1.0 | stable | Not tested | Not yet tested Details | 2022-04-29 11:50:41 |
| 1.0.1 | stable | Not tested | Not yet tested Details | 2022-03-18 19:28:30 |
| 1.0.0 | stable | Not tested | Not yet tested Details | 2022-03-18 19:27:50 |
Requires 9
| Package | Constraint |
|---|---|
| dhl/module-carrier-paket | ^3.4.0 |
| dhl/module-shipping-core | ^2.5.0 |
| magento/framework | ^103.0.8 |
| magento/module-config | ^101.2.8 |
| magento/module-sales | ^103.0.8 |
| magento/module-shipping | ^100.4.8 |
| magento/module-store | ^101.1.8 |
| netresearch/module-shipping-core | ^4.0.0 |
| php | ~8.3.0||~8.4.0||~8.5.0 |
Compatibility
Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.
Code Quality
Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge — a phpcs finding can't make a module incompatible.
Static analysis
Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.
PHPStan
Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases. Cell → details modal.
Tests
Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.
Unit tests
| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | ||
| 2.4.8 | N/A | N/A | ||
| 2.4.9 | N/A | N/A |
Integration tests
| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | ||
| 2.4.8 | N/A | N/A | ||
| 2.4.9 | N/A | N/A |
Security
Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.
More from dhl
View vendorIntegrate the DPDHL Group tracking web service into Magento® 2 carrier modules.
DHL multi-division shipping extension for Magento 2
Carrier implementation for DHL Business Customer Shipping Returns
DHL component providing utilities and frameworks for advanced shipping features
Turn an existing module into recurring revenue.
If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.