PHPackages dhl/sdk-api-bcs-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. dhl/sdk-api-bcs-returns ActiveLibrary[API Development](/categories/api) dhl/sdk-api-bcs-returns ======================= DHL Paket Retoure API SDK 2.1.2(3y ago)3237.5k↓16.3%8[1 PRs](https://github.com/netresearch/dhl-sdk-api-bcs-returns/pulls)1MITPHPPHP ^7.2.0 || ^8.0.0 Since Jan 16Pushed 2mo ago8 watchersCompare [ Source](https://github.com/netresearch/dhl-sdk-api-bcs-returns)[ Packagist](https://packagist.org/packages/dhl/sdk-api-bcs-returns)[ Docs](https://entwickler.dhl.de/group/ep/wsapis/retouren)[ RSS](/packages/dhl-sdk-api-bcs-returns/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)Dependencies (15)Versions (9)Used By (1) 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.2+ 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 dhl/sdk-api-bcs-returns ``` Uninstallation -------------- [](#uninstallation) ``` $ composer remove dhl/sdk-api-bcs-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 = 'deu'); $requestBuilder->setShipperAddress( $name = 'Jane Doe', $countryCode = 'DEU', $postalCode = '53113', $city = 'Bonn', $streetName = 'Sträßchensweg', $streetNumber = '2' ); $returnOrder = $requestBuilder->create(); $confirmation = $service->bookLabel($returnOrder); ``` ### Health Score 49 — FairBetter than 95% of packages Maintenance57 Moderate activity, may be stable Popularity39 Limited adoption so far Community22 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 Every ~232 days Recently: every ~279 days Total 6 Last Release 1148d ago Major Versions 1.0.0 → 2.0.02020-03-04 PHP version history (3 changes)1.0.0PHP ^7.0.0 2.0.0PHP ^7.1.0 2.1.0PHP ^7.2.0 || ^8.0.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/efd68399f95aa07110668d9af1a47a8030d8df5ec5af4b28e821d442d787583a?d=identicon)[team-mage](/maintainers/team-mage) --- Top Contributors [![mam08ixo](https://avatars.githubusercontent.com/u/1771622?v=4)](https://github.com/mam08ixo "mam08ixo (13 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)")[![Sebastian80](https://avatars.githubusercontent.com/u/6400300?v=4)](https://github.com/Sebastian80 "Sebastian80 (4 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (3 commits)")[![CybotTM](https://avatars.githubusercontent.com/u/326348?v=4)](https://github.com/CybotTM "CybotTM (1 commits)") --- Tags api-clientdhl-apidhl-paket-retouredhl-sdkphpphp-librarysdkphpsdkdhl ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/dhl-sdk-api-bcs-returns/health.svg) ``` [![Health](https://phpackages.com/badges/dhl-sdk-api-bcs-returns/health.svg)](https://phpackages.com/packages/dhl-sdk-api-bcs-returns) ``` ### Alternatives [phpro/http-tools HTTP tools for developing more consistent HTTP implementations. 28137.8k](/packages/phpro-http-tools)[openai-php/client OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API 5.8k22.6M232](/packages/openai-php-client)[opensearch-project/opensearch-php PHP Client for OpenSearch 15224.3M65](/packages/opensearch-project-opensearch-php)[getbrevo/brevo-php Official Brevo provided RESTFul API V3 php library 963.1M35](/packages/getbrevo-brevo-php)[mozex/anthropic-php Anthropic PHP is a supercharged community-maintained PHP API client that allows you to interact with Anthropic API. 46365.1k13](/packages/mozex-anthropic-php)[swisnl/json-api-client A PHP package for mapping remote JSON:API resources to Eloquent like models and collections. 211473.2k12](/packages/swisnl-json-api-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)