According to https://entwickler.dhl.de/group/ep/wsapis/retouren/authentifizierung
the receiverID is not DE but deu:

Please add PHP 8.1 support

Hello,

we want to upgrade Laravel 9 to 1, but monolog need psr/log ^2.* support.

Can you please update the dependencies with support for PHP 8.1?

Thank you very much.

Named parameters like in

$requestBuilder->setAccountDetails($receiverId = 'DE');

are not available in any PHP 7 version yet.

It is a feature planned for PHP 8 with people trying to backport it to PHP 7 but it has not yet been merged.

RFC: https://wiki.php.net/rfc/named_params
Merge request: php/php-src#5357
Version poc: https://3v4l.org/OoPIe

Hello,
Can I change the Return Label size other than A4? Because I wanted to print on a label printer with size 103 x 199 mm.

Thanks!

I am receiving the following error when using the SDK to create a return label:

Undefined index: qrLabelData in vendor/dhl/sdk-api-bcs-returns/src/Service/ReturnLabelService.php on line 92

So far I received this error while creating a return label for Spain and Finland. I am not sure how many other countries are affected. The line in question:

$qrLabelData = $responseData['qrLabelData'] ?: '';

should probably be:

$qrLabelData = $responseData['qrLabelData'] ?? '';

since it seems the qrLabelData key can be missing entirely. I was able to reproduce this error for both the sandbox and the live API.

Using version 2.0.1 atm, but seems to be the same code in master.

Error:

Argument 1 passed to Dhl\Sdk\Paket\Retoure\Http\ClientPlugin\ReturnLabelErrorPlugin::createErrorMessage() must be of the type array, null given, called in /var/www/html/vendor/dhl/sdk-api-bcs-returns/src/Http/ClientPlugin/ReturnLabelErrorPlugin.php on line 85

Link (master): https://github.com/netresearch/dhl-sdk-api-bcs-returns/blob/master/src/Http/ClientPlugin/ReturnLabelErrorPlugin.php#L85

What happen:
The response body seems to be empty.
So json_decode will return NULL because it cannot decode.
At $this->createErrorMessage() we then provide NULL to an expected array parameter which causes the error.

Info:
DHL currently has some error or maintenance on the retoure API
and i guess they return an empty body.

Funktion Retoure: Aufgrund eines Fehlers ist die Funktion aktuell nicht aufrufbar. Die Fehlerbehebung ist bereits in Arbeit. Wir bitte um Entschuldigung für die Unannehmlichkeiten.

Possible solution:

$responseJson = (string)$response->getBody();
$responseData = \json_decode($responseJson, true);
if (!is_array($responseData)) {
    // Could not json_decode body.
    // This could be an empty body due to Maintenance at DHL retoure API.
    $responseData = [];
}
$errorMessage = $this->createErrorMessage($responseData, $response->getReasonPhrase());

Receiving Bad request (Error 400) (and nothing more) from DHL if the name contains special chars like à.

Note: the source of the name string was in my case another api.

When i tried to copy and past the name it worked. Seems to be an encoding problem.

Im posting this because the DHL API does not mention anything about that.

You only get 400 | Fehlerhafter Aufruf(Bad Request). | Syntax des Aufrufs prüfen. from the documentation.

Where: at the shipper address name:

$requestBuilder->setShipperAddress(
    $name = 'Adrià Fernández', // <---------------------
    $countryCode = 'DEU',
    $postalCode = '53113',
    $city = 'Bonn',
    $streetName = 'Sträßchensweg',
    $streetNumber = '2'
);

I fixed this using $name = utf8_encode($name); before sending it to DHL.
But this is more like a quick fix, since the label then prints Ã.

EDIT:
found the actual cause of my problem: i had a regex that was not using the u-option (/.../u ).\