PHPackages                             enbit/dhl-returns-rest-api - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. enbit/dhl-returns-rest-api

ActiveLibrary[HTTP &amp; Networking](/categories/http)

enbit/dhl-returns-rest-api
==========================

DHL Retoure Rest API

1.0.0(4y ago)0286[1 issues](https://github.com/enbit/dhl-returns-rest-api/issues)MITPHPPHP &gt;=7.1.0

Since Apr 28Pushed 4y ago1 watchersCompare

[ Source](https://github.com/enbit/dhl-returns-rest-api)[ Packagist](https://packagist.org/packages/enbit/dhl-returns-rest-api)[ Docs](https://entwickler.dhl.de/group/ep/wsapis/retouren)[ RSS](/packages/enbit-dhl-returns-rest-api/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (2)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 7.1+ with JSON extension

### Package Requirements

[](#package-requirements)

- `guzzlehttp/guzzle`

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

[](#installation)

```
$ composer require enbit/dhl-returns-rest-api
```

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.

```
use Enbit\Dhl\Retoure\Auth\AuthenticationStorage;
use Enbit\Dhl\Retoure\Service\ServiceFactory;
use Enbit\Dhl\Retoure\Model\ReturnLabelRequestBuilder;

$authStorage = new AuthenticationStorage(
    'applicationId',
    'applicationToken',
    'user',
    'signature'
);

$serviceFactory = new ServiceFactory(
    $authStorage,
    $sandbox = true
);
$service = $serviceFactory->createReturnLabelService();

$requestBuilder = new 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);

$confirmation->getLabelData();
$confirmation->getQrLabelData();
$confirmation->getRoutingCode();
$confirmation->getShipmentNumber();
```

###  Health Score

23

—

LowBetter than 30% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1791d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5598cb393dc3bd9b2069b6187c6af0d2d3d51f487233310449c0b6c99370064f?d=identicon)[ahmad-saad](/maintainers/ahmad-saad)

---

Top Contributors

[![ahmad-saad](https://avatars.githubusercontent.com/u/1744614?v=4)](https://github.com/ahmad-saad "ahmad-saad (2 commits)")

---

Tags

phpapisdkrestdhl

### Embed Badge

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

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

PHPackages © 2026

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