ShipmentOrderRequestBuilder::setRecipientAddress(): Argument #3 ($postalCode) must be of type string, null given

[mkleisti]

Ich schon wieder :)

Für die Länder, welche nicht am Postleitzahl System teilnehmen, wie zB Irland oder Städte wie Dubai.

Laut DHL Support, muss hier NULL übermittelt werden oder consignee.postalCode komplett weggelassen werden.
Getestet mit JSON & cURL, an einer Adresse in Dubai ohne ZipCode und kann es bestätigten, das DHL dann validiert mit TRUE und man auch ein Etikett erhält.

Wenn ich jedoch ein $requestBuilder->setRecipientAddress( ... postalCode: (!empty($liefer['lie_plz']))?$liefer['lie_plz']:NULL, ... ); mache und als Testadresse die gleich verwende, wie die in meinem JSON.
Dann erhalte ich diese Fehlermeldung, da ein String verlangt wird.

PHP Fatal error: Uncaught TypeError: Dhl\Sdk\ParcelDe\Shipping\RequestBuilder\ShipmentOrderRequestBuilder::setRecipientAddress(): Argument #3 ($postalCode) must be of type string, null given, called in

Aber bei einem leeren String im postalCode: wie bei streetNumber: kommt von DHL ein

0 => string 'In der Sendung trat mindestens ein harter Fehler auf.' (length=53)
1 => string 'consignee.postalCode' (length=20)
2 => string 'Der Parameter postalCode muss eine valide Postleitzahl nach UPU sein.' (length=69)
3 => string 'consignee.postalCode' (length=20)
4 => string 'Der Parameter postalCode muss zwischen 3 und 10 Zeichen lang sein.' (length=66)

[powli]

Hi,

we added a test in commit c37e814 that confirms the expected behavior: when you pass an empty string '' for postalCode to setRecipientAddress(), the JsonSerializer::filterRecursive() strips it from the serialized JSON before it is sent to the DHL API. The consignee.postalCode field will not be present in the request.

So for countries without postal codes (e.g. UAE, Ireland), the correct usage is:

$requestBuilder->setRecipientAddress(
    'Jane Doe',
    'ARE',
    '',  // empty string — will be omitted from the API request
    'Dubai',
    'Sheikh Zayed Road',
);

This is the same mechanism that already handles empty streetNumber (see #9).

Could you provide the actual JSON request body that was sent to the DHL API and the input data you used with the SDK? That would help us reproduce the validation error you described. You can capture the request payload via the SDK's logger or an HTTP proxy.