PHPackages                             dhl/sdk-api-unified-tracking - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. dhl/sdk-api-unified-tracking

ActiveLibrary[API Development](/categories/api)

dhl/sdk-api-unified-tracking
============================

DPDHL Group unified shipment tracking API SDK

2.4.0(11mo ago)2311.1k—8.8%1MITPHPPHP ^8.1.0

Since Jan 16Pushed 10mo ago8 watchersCompare

[ Source](https://github.com/netresearch/dhl-sdk-api-unified-tracking)[ Packagist](https://packagist.org/packages/dhl/sdk-api-unified-tracking)[ RSS](/packages/dhl-sdk-api-unified-tracking/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (19)Versions (11)Used By (1)

DPDHL Group unified shipment tracking API SDK
=============================================

[](#dpdhl-group-unified-shipment-tracking-api-sdk)

The Shipment Tracking API provides up-to-the-minute shipment status reports. Users of this API can:

- Retrieve tracking information for shipments.
- Identify the Deutsche Post DHL (DPDHL) service provider involved with the shipment.
- Verify DPDHL is using the correct delivery address. This can reduce the number of misdelivered shipments.

Requirements
------------

[](#requirements)

### System Requirements

[](#system-requirements)

- PHP 8.1+ with JSON extension

### Package Requirements

[](#package-requirements)

- `netresearch/jsonmapper`: Mapper for deserialization of JSON response messages into PHP objects
- `php-http/discovery`: Discovery service for HTTP client and message factory implementations
- `php-http/httplug`: Pluggable HTTP client abstraction
- `php-http/logger-plugin`: HTTP client logger plugin for HTTPlug
- `psr/http-client`: PSR-18 HTTP client interfaces
- `psr/http-factory`: PSR-7 HTTP message factory interfaces
- `psr/http-message`: PSR-7 HTTP message interfaces
- `psr/log`: PSR-3 logger interfaces

### Virtual Package Requirements

[](#virtual-package-requirements)

- `psr/http-client-implementation`: Any package that provides a PSR-18 compatible HTTP client
- `psr/http-factory-implementation`: Any package that provides PSR-7 compatible HTTP message factories
- `psr/http-message-implementation`: Any package that provides PSR-7 HTTP messages

### Development Package Requirements

[](#development-package-requirements)

- `fig/log-test`: PSR-3 logger implementation for testing purposes
- `nyholm/psr7`: PSR-7 HTTP message factory & message implementation
- `phpunit/phpunit`: Testing framework
- `php-http/mock-client`: HTTPlug mock client implementation
- `phpstan/phpstan`: Static analysis tool
- `rector/rector`: Automatic refactoring tool to help with PHP upgrades
- `squizlabs/php_codesniffer`: Static analysis tool
- `symfony/finder`: file utility for loading pre-recorded web service responses

Installation
------------

[](#installation)

```
$ composer require dhl/sdk-api-unified-tracking
```

Uninstallation
--------------

[](#uninstallation)

```
$ composer remove dhl/sdk-api-unified-tracking
```

Testing
-------

[](#testing)

```
$ ./vendor/bin/phpunit -c test/phpunit.xml
```

Static code analysis
--------------------

[](#static-code-analysis)

```
$ ./vendor/bin/phpstan --level=7 analyze ./src/
```

```
$ ./vendor/bin/phpcs --standard=PSR12 src/ test/
```

Features
--------

[](#features)

The DPDHL Group unified shipment tracking API SDK supports the following features:

- Fetch advanced information about a trackable shipment

### Tracking Service

[](#tracking-service)

Fetch information about shipment status of a trackable shipment no matter which business unit of DHL is actually processing the shipment. Additional search parameters can be provided to narrow down possible search results.

#### Public API

[](#public-api)

The library's components suitable for consumption comprise

- service:
    - service factory
    - tracking service
- data transfer objects:
    - track information with detailed shipment events

#### Usage

[](#usage)

```