nebbia-fitness/dhl-express-php-sdk

DHL Express SDK

Maintainers

Details

github.com/nebbia-fitness/dhl-express-php-sdk

Source

Installs: 422

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 7

0.2.1 2020-11-09 11:05 UTC

Requires

MIT 99328a3035d062dec9c8e58776ecca4cb7513315

  • Alexander Reichardt <mail.woop@alexander-reichardt.de>
  • Lukas Mestan <lukas.mestan.woop@gmail.com>

This package is auto-updated.

Last update: 2024-11-09 20:12:28 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 nebbia-fitness/dhl-express-php-sdk

Supported API Operations

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.