PHPackages                             rsemenyshyn/dhl-sdk-api-returns - 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. rsemenyshyn/dhl-sdk-api-returns

ActiveLibrary[API Development](/categories/api)

rsemenyshyn/dhl-sdk-api-returns
===============================

DHL Paket Retoure API SDK, froked and adjusted to be friendly with PHP 5.6

048PHP

Since Aug 11Pushed 4y agoCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

DHL Paket Retoure API SDK
=========================

[](#dhl-paket-retoure-api-sdk)

The DHL Paket Retoure API SDK package offers an interface to the following web services:

- API Retoure

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

[](#requirements)

### System Requirements

[](#system-requirements)

- PHP 5.6+ with JSON extension

### Package Requirements

[](#package-requirements)

- `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)

- `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
- `squizlabs/php_codesniffer`: Static analysis tool

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

[](#installation)

```
$ composer require rsemenyshyn/dhl-sdk-api-returns
```

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

[](#uninstallation)

```
$ composer remove rsemenyshyn/dhl-sdk-api-returns
```

Testing
-------

[](#testing)

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

Features
--------

[](#features)

The DHL Paket Retoure API SDK supports the following features:

- Book return labels ([`BookLabel`](https://entwickler.dhl.de/group/ep/wsapis/retouren))

### Return Label Service

[](#return-label-service)

Create a return label PDF or QR code to be scanned by a place of committal (e.g. post office). For return shipments from outside of the EU, a customs document can also be requested.

#### Public API

[](#public-api)

The library's components suitable for consumption comprise of

- service:
    - service factory
    - return label service
    - data transfer object builder
- data transfer objects:
    - authentication storage
    - booking confirmation with label data

#### Usage

[](#usage)

```
$authStorage = new \Dhl\Sdk\Paket\Retoure\Auth\AuthenticationStorage(
    'applicationId',
    'applicationToken',
    'user',
    'signature'
);
$logger = new \Psr\Log\NullLogger();

$serviceFactory = new \Dhl\Sdk\Paket\Retoure\Service\ServiceFactory();
$service = $serviceFactory->createReturnLabelService($authStorage, $logger, $sandbox = true);

$requestBuilder = new \Dhl\Sdk\Paket\Retoure\Model\ReturnLabelRequestBuilder();
$requestBuilder->setAccountDetails($receiverId = 'DE');
$requestBuilder->setShipperAddress(
    $name = 'Jane Doe',
    $countryCode = 'DE',
    $postalCode = '53113',
    $city = 'Bonn',
    $streetName = 'Sträßchensweg',
    $streetNumber = '2'
);

$returnOrder = $requestBuilder->create();
$confirmation = $service->bookLabel($returnOrder);
```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/2ccf8599aff30a03907b9a592f280de942df37c2d9e43c85fab971b2497ea789?d=identicon)[rsemenyshyn](/maintainers/rsemenyshyn)

---

Top Contributors

[![rsemenyshyn](https://avatars.githubusercontent.com/u/5583070?v=4)](https://github.com/rsemenyshyn "rsemenyshyn (46 commits)")[![mam08ixo](https://avatars.githubusercontent.com/u/1771622?v=4)](https://github.com/mam08ixo "mam08ixo (9 commits)")[![AndreasMueller75](https://avatars.githubusercontent.com/u/32193606?v=4)](https://github.com/AndreasMueller75 "AndreasMueller75 (8 commits)")[![magicsunday](https://avatars.githubusercontent.com/u/564393?v=4)](https://github.com/magicsunday "magicsunday (6 commits)")

### Embed Badge

![Health badge](/badges/rsemenyshyn-dhl-sdk-api-returns/health.svg)

```
[![Health](https://phpackages.com/badges/rsemenyshyn-dhl-sdk-api-returns/health.svg)](https://phpackages.com/packages/rsemenyshyn-dhl-sdk-api-returns)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)