dhl / module-carrier-paket-returns

dhl/module-carrier-paket-returns

Carrier implementation for DHL Business Customer Shipping Returns

magento2-module Compatibility: 2.4.8-2.4.9 Code Quality: Fail Tests: Fail Security: Pass OSL-3.0

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-core package 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

Versions
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.

Compatibility matrix (Magento × PHP)
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 not tested not tested
2.4.8 Pass Pass
2.4.9 Pass Pass

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.

Static analysis results
Tool Status Findings Summary
PHPCS Warning 19 19 warnings (ruleset: Magento2)
PHPMD Warning 4 4 rule violations (UnusedFormalParameter:2, ExcessiveParameterList:1, MissingImport:1)
Cpd Pass 0
Composer validate Info 1 valid; 1 advisory note (composer validate --strict)

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.

PHPStan results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A Error
2.4.8 14 14
2.4.9 14 14

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

Unit tests results by Magento and PHP version
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

Integration tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A Error
2.4.8 Pass Pass
2.4.9 Pass Pass

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.

Security results
Tool Status Findings Summary
Composer audit Pass 0
Malware scan Pass 0
License
OSL-3.0
Authors

More from dhl

View vendor
Make it pay

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.