dhl / module-carrier-paket-returns
dhl/module-carrier-paket-returns
Carrier implementation for DHL Business Customer Shipping Returns
DHL Paket Returns Shipping Carrier Extension
The DHL Paket Returns extension for Magento® 2 integrates the DHL Retoure API
API into the order processing workflow.
Description
This extension enables merchants to request return labels for orders
via the DHL Retoure API (DHL Geschäftskundenversand-API).
Requirements
- PHP >= 8.3
- PHP JSON extension
Compatibility
- Magento >= 2.4.8
Installation Instructions
Install sources:
composer require dhl/module-carrier-paket-returns
Enable module:
./bin/magento module:enable Dhl_PaketReturns
./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_PaketReturns
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.
2.5.0
Magento 2.4.9 compatibility release
Added
- Support for Magento 2.4.9
- Support for PHP 8.5
2.4.0
Magento 2.4.8 compatibility release
Added
- Support for Magento 2.4.8
- Support for PHP 8.4
Changed
- Modernized codebase with PHP 8+ features (nullable types, union types,
#[\Override]attributes) - Updated strict type declarations for PHP 8.3+ compatibility
Removed
- Support for PHP 8.2
2.3.0
Magento 2.4.7 compatibility release
Changed
- Switch from Zend_Measurement to Magento Framework Measurement
- Use escaper instead of block for escaping in templates
Removed
- Support for PHP 7.x
- Support for PHP 8.1
Changed
- Switch from DHL Retoure API to DHL Parcel DE Returns API.
2.2.2
Changed
- Establish compatibility to
netresearch/module-shipping-core:2.9.0.
Fixed
- Prevent broken styling in module configuration, reported via #50.
2.2.1
Fixed
- Do not persist empty QR labels from cross-border returns.
2.2.0
Magento 2.4.4 compatibility release
Added
- Support for Magento 2.4.4
Removed
- Support for PHP 7.1
2.1.0
Added
- Import DHL Business Customer Portal Receiver IDs CSV file to module configuration.
- Configure carrier title.
Removed
- Remove obsolete config fields.
2.0.3
Changed
- Move returns feature to shipping core and ui modules.
2.0.2
Changed
- Print order number instead of billing number as customer reference on shipping labels.
2.0.1
Changed
- Use
netresearch/module-shipping-corepackage for three-letter country code calculation.
Fixed
- Add missing sandbox Receiver ID configuration for Italy.
2.0.0
Changed
- Replace shipping core package dependency.
1.1.1
Changed
- Update infobox text in module configuration.
1.1.0
Magento 2.4 compatibility release
Added
- Support for Magento 2.4
Removed
- Support for Magento 2.2
Changed
- Update sandbox Receiver IDs according to developer portal listing.
Fixed
- Allow letters in Participation Numbers configuration.
1.0.1
Bugfix release
Fixed
- Update Receiver IDs configuration setting for sandbox access.
1.0.0
Initial release
| Version | Stability | QA Status | Compatibility | Released |
|---|---|---|---|---|
| 2.5.0 | stable | Fail | Magento 2.4.8-2.4.9 Details | 2026-06-03 09:36:52 |
| 2.4.0 | stable | Not tested | Not yet tested Details | 2025-07-02 14:47:57 |
| 2.3.0 | stable | Not tested | Not yet tested Details | 2024-05-28 11:40:53 |
| 2.2.2 | stable | Not tested | Not yet tested Details | 2023-04-11 10:43:54 |
| 2.2.1 | stable | Not tested | Not yet tested Details | 2022-05-25 08:11:14 |
| 2.2.0 | stable | Not tested | Not yet tested Details | 2022-04-29 11:48:00 |
| 2.1.0 | stable | Not tested | Not yet tested Details | 2022-04-06 12:04:23 |
| 2.0.3 | stable | Not tested | Not yet tested Details | 2021-10-28 14:10:30 |
| 2.0.2 | stable | Not tested | Not yet tested Details | 2021-08-26 11:58:34 |
| 2.0.1 | stable | Not tested | Not yet tested Details | 2021-04-28 09:31:45 |
| 2.0.0 | stable | Not tested | Not yet tested Details | 2021-04-07 12:14:08 |
| 1.1.1 | stable | Not tested | Not yet tested Details | 2021-01-26 13:07:33 |
| 1.1.0 | stable | Not tested | Not yet tested Details | 2021-01-26 10:37:31 |
| 1.0.1 | stable | Not tested | Not yet tested Details | 2020-06-26 10:49:40 |
| 1.0.0 | stable | Not tested | Not yet tested Details | 2020-04-02 08:30:04 |
Requires 15
| Package | Constraint |
|---|---|
| dhl/module-shipping-core | ^2.5.0 |
| dhl/sdk-api-parcel-de-returns | ^1.2.0 |
| ext-json | * |
| magento/framework | ^103.0.8 |
| magento/module-catalog-inventory | ^100.4.8 |
| magento/module-config | ^101.2.8 |
| magento/module-directory | ^100.4.8 |
| magento/module-media-storage | ^100.4.7 |
| magento/module-quote | ^101.2.8 |
| magento/module-sales | ^103.0.8 |
| magento/module-shipping | ^100.4.8 |
| magento/module-store | ^101.1.8 |
| netresearch/config-fields-m2 | ^1.3.0 |
| netresearch/module-shipping-core | ^4.0.0 |
| php | ~8.3.0||~8.4.0||~8.5.0 |
Requires-dev 1
| Package | Constraint |
|---|---|
| phpunit/phpunit | ^10.5.0 |
Suggests 1
| Package | Reason |
|---|---|
| magento/module-rma | * |
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 |
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 vendorOptional component to assign incoming orders to the DHL Paket carrier.
Integrate the DPDHL Group tracking web service into Magento® 2 carrier modules.
DHL multi-division shipping extension for Magento 2
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.