be-lenka/dhl-express-php-sdk

DHL Express SDK

Maintainers

Details

github.com/be-lenka/dhl-express-php-sdk

Source

Issues

Installs: 319

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

dev-master 2022-02-18 06:59 UTC

Requires

MIT 0d984d3fab9ac31e8538359bd566837ee49e2264

  • Alexander Reichardt <mail.woop@alexander-reichardt.de>
  • Blueweb <info.woop@blueweb.sk>
  • Be Lenka <hello.woop@belenka.dev>

This package is auto-updated.

Last update: 2024-04-18 12:35:01 UTC

README

This unoffical library is wrapping some functions of the DHL Express JSON/REST API (called MyDHL_API).

To get a SDK for standard DHL shipping, please have a look at the great SDK from Petschko i've used for inspiration.

Requirements

  • test (and live) credentials from the DHL Express Tech Contact
  • PHP-Version 5.5 or higher (It may work on older Versions, but I don't offer Support for these)
  • Guzzle installed

Compatibility

This Project is written for the MyDHL API v1.

Install

You can use Composer to install the package to your project:

composer require be-lenka/dhl-express-php-sdk

Supported API Operations

Operation supported
RateRequest no
ShipmentRequest yes
TrackingRequest no
DocumentRetrieve no
updateShipment no
requestPickup no

Usage

see examples for basic examples and scripts to generate test labels (see below)

Request Access to live API

To get the credentials for the live account, DHL requested test labels for some scenarios:

The test scripts can be found in the examples folder:

  1. National shipping with saturday delivery - test_1.php
  2. National shipping time option and 2 packages - test_2.php
  3. International shipping not liable to duty - test_3.php
  4. International shipping liable to duty - test_4.php
  5. International shipping liable to duty with service DDP - test_5.php
  6. International shipping liable to duty with different payment account - test_6.php

Things i've learned during testing the API

  • The "InternationalDetail" part is mandatory even if its national package
  • StreetName and StreetNumber in der Address don't have any effect right now, the "StreetLines" field is always used
  • Company Name in the Recipient address is the name on the package (first line)
  • Package Dimensions are mandatory, but they don't have to be exact (DHL will check them anyway) - so it is possible to always use the smallest package size you have
  • "StreetLine" could not be used for any additional name - use "StreetLines2" for this - always use it for street name and number

More details will follow soon. This package is WIP.