PHPackages dreipunktnull/dhl-express - 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 & Networking](/categories/http) 4. / 5. dreipunktnull/dhl-express AbandonedArchivedLibrary[HTTP & Networking](/categories/http) dreipunktnull/dhl-express ========================= DHL Express Soap CLient v2.0.2(8y ago)1064.2k↓33.8%4MITPHPPHP >=7.0.8 Since Oct 6Pushed 7y ago3 watchersCompare [ Source](https://github.com/dreipunktnull/dhl-express)[ Packagist](https://packagist.org/packages/dreipunktnull/dhl-express)[ RSS](/packages/dreipunktnull-dhl-express/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (2)Versions (6)Used By (0) DHL Express SOAP API client =========================== [](#dhl-express-soap-api-client) A generated SOAP API client for the [DHL Express Global Webservice](https://www.dhl.com). Installation ------------ [](#installation) To install the package, you can use composer: ``` composer require dreipunktnull/dhl-express ``` Usage without composer is currently not possible and needs some adjustments in the provided autoloader. Shipment Requests ----------------- [](#shipment-requests) A shipment request is usually created through the webservice and in order to mutate (f.e. cancel) it, we need some parameters. You should therefore create your own `ShipmentRequest` data class and persist the `ShipmentDetail` data points. As of now, no such class is included. ``` class ShipmentRequestService { /** * @var string */ private $user; /** * @var string */ private $password; /** * @var string */ private $accountNumber; /** * @param string $user * @param string $password * @param string $accountNumber */ public function __construct(string $user, string $password, string $accountNumber) { $this->user = $user; $this->password = $password; $this->accountNumber = $accountNumber; } /** * @param \DateTimeInterface $shipTimestamp * @param ContactInfoType $sender * @param ContactInfoType $recipient * @param ShipmentRequest $shipmentRequest * @param string|null $restrictToServiceType * * @return \DHL\Express\Webservice\ShipmentDetailType */ public function createShipping(\DateTimeInterface $shipTimestamp, ContactInfoType $sender, ContactInfoType $recipient, ShipmentRequest $shipmentRequest, $restrictToServiceType = null) { $webservice = $this->prepareWebservice(); $shipmentInfo = new ShipmentInfoType( DropOffType::REQUEST_COURIER, $this->calculateShippingType($shipmentRequest), ShipmentInfoType::CURRENCY_EUR, UnitOfMeasurement::SI ); $shipmentInfo->setAccount($this->accountNumber); $internationalDetail = new InternationDetailType(new CommoditiesType('Keine Angabe')); $internationalDetail->setContent(Content::DOCUMENTS); $requestedShipment = new RequestedShipmentType( $shipmentInfo, sprintf('%sT%s GMT+01:00', $shipTimestamp->format('Y-m-d'), $shipTimestamp->format('H:i:s')), PaymentInfo::DDP, $internationalDetail, new ShipType($sender, $recipient), new docTypeRef_PackagesType( new docTypeRef_RequestedPackagesType( self::PACKAGE_WEIGHT, new docTypeRef_DimensionsType(self::PACKAGE_LENGTH, self::PACKAGE_WIDTH, self::PACKAGE_HEIGHT), '1', 1, 'No Description' ) ) ); if (null !== $shipmentRequest->getSpecialPickupInstruction()) { $requestedShipment->setSpecialPickupInstruction($shipmentRequest->getSpecialPickupInstruction()); } if (null !== $shipmentRequest->getPickupLocation()) { $requestedShipment->setPickupLocation($shipmentRequest->getPickupLocation()); } if ($shipTimestamp instanceof \DateTimeImmutable) { $pickupLocationCloseTime = $shipTimestamp->modify('+91 minutes'); } else { $pickupLocationCloseTime = \DateTimeImmutable::createFromMutable($shipTimestamp)->modify('+91 minutes'); } $requestedShipment->setPickupLocationCloseTime($pickupLocationCloseTime->format('H:i')); $request = new ProcessShipmentRequestType($requestedShipment); $shipmentDetailType = $webservice->createShipmentRequest($request); return $shipmentDetailType; } /** * This should only be done if the pickup type is something other than PickupType::Regular. * * @param ShipmentRequest $shipmentRequest * @param string $requester This parameter is required but won't be evaluated. * @param string $reason This parameter is optional but may be useful. * @return DeleteResponseType */ public function cancel(ShipmentRequest $shipmentRequest, $requester = 'ERNIE_OR_BERT', $reason = DeleteRequestType::REASON_REASON_NOT_GIVEN): DeleteResponseType { $webservice = $this->prepareWebservice(); $deleteRequest = new DeleteRequestType( $shipmentRequest->getShipmentTime()->format('Y-m-d'), $shipmentRequest->getPickupCountry(), $shipmentRequest->getDispatchConfirmationNumber(), $requester ); $deleteRequest->setReason($reason); return $webservice->deleteShipmentRequest($deleteRequest); } /** * @return GblDHLExpressTrack */ private function prepareWebservice(): GblDHLExpressTrack { $track = new GblDHLExpressTrack(['trace' => 1]); $wsse_header = WssWsuAuthHeader::soapClientWSSecurityHeader($this->user, $this->password, $this->accountNumber); $track->__setSoapHeaders([$wsse_header]); return $track; } } ``` Tracking -------- [](#tracking) Example Tracking Service that is able to authenticate and track a package: ``` use DHL\Express\Webservice\Soap\WssWsuAuthHeader; use DHL\Express\Webservice\Tracking\ArrayOfAWBNumber; use DHL\Express\Webservice\Tracking\GblDHLExpressTrack; use DHL\Express\Webservice\Tracking\LevelOfDetails; use DHL\Express\Webservice\Tracking\PublicTrackingRequest; use DHL\Express\Webservice\Tracking\Request; use DHL\Express\Webservice\Tracking\ServiceHeader; use DHL\Express\Webservice\Tracking\TrackingRequest; use DHL\Express\Webservice\Tracking\TrackShipmentRequest; use Ramsey\Uuid\Uuid; class TrackingService { /** * @var string */ private $user; /** * @var string */ private $password; /** * @var string */ private $accountNumber; /** * @param string $user * @param string $password * @param string $accountNumber */ public function __construct(string $user, string $password, string $accountNumber) { $this->user = $user; $this->password = $password; $this->accountNumber = $accountNumber; } /** * Tracks a package. * * @param string $trackingNumber * @param string $levelOfDetails * @return \DHL\Express\Webservice\Tracking\trackShipmentRequestResponse */ public function track($trackingNumber, $levelOfDetails = LevelOfDetails::LAST_CHECK_POINT_ONLY) { $webservice = $this->prepareWebservice(); $parameters = new TrackShipmentRequest(); $trackingRequest = new TrackingRequest(new Request(new ServiceHeader(new \DateTime(), implode('', explode('-', Uuid::uuid4())))), $levelOfDetails); $trackingRequest->setAWBNumber(new ArrayOfAWBNumber([$trackingNumber])); $parameters->setTrackingRequest(new PublicTrackingRequest($trackingRequest)); return $webservice->trackShipmentRequest($parameters); } /** * @return GblDHLExpressTrack */ private function prepareWebservice(): GblDHLExpressTrack { $track = new GblDHLExpressTrack(['trace' => 1]); $wsse_header = WssWsuAuthHeader::soapClientWSSecurityHeader($this->user, $this->password, $this->accountNumber); $track->__setSoapHeaders([$wsse_header]); return $track; } } ``` Acknowledgements ---------------- [](#acknowledgements) The base version of this library was generated with [wsdl2phpgenerator](https://github.com/wsdl2phpgenerator/wsdl2phpgenerator). Support ------- [](#support) Please use the GitHub issue tracker. For commercial support for your project contact [dreipunktnull](https://dreipunktnull.com). License ------- [](#license) MIT ### Health Score 37 — LowBetter than 83% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity37 Limited adoption so far Community12 Small or concentrated contributor base Maturity62 Established project with proven stability 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 Every ~27 days Total 5 Last Release 3038d ago Major Versions v1.0.1 → v2.0.02017-10-12 ### Community Maintainers ![](https://www.gravatar.com/avatar/2ac8297e12671d91305ec01ab56add8cb141fa82d678ba96f0012eeb7f88ea0c?d=identicon)[cedricziel](/maintainers/cedricziel) ![](https://www.gravatar.com/avatar/e98f22b5c566b4e7e0a0b8cae88e5841ec4053c5d1473d64e6e5b56116837b29?d=identicon)[bjo3rnf](/maintainers/bjo3rnf) --- Top Contributors [![cedricziel](https://avatars.githubusercontent.com/u/418970?v=4)](https://github.com/cedricziel "cedricziel (19 commits)") --- Tags dhlphp ### Embed Badge ![Health badge](/badges/dreipunktnull-dhl-express/health.svg) ``` [![Health](https://phpackages.com/badges/dreipunktnull-dhl-express/health.svg)](https://phpackages.com/packages/dreipunktnull-dhl-express) ``` ### Alternatives [shopify/shopify-api Shopify API Library for PHP 4634.8M16](/packages/shopify-shopify-api)[launchdarkly/server-sdk Official LaunchDarkly SDK for PHP 3810.2M11](/packages/launchdarkly-server-sdk)[launchdarkly/launchdarkly-php Official LaunchDarkly SDK for PHP 392.0M4](/packages/launchdarkly-launchdarkly-php)[qandidate/stack-request-id Middleware for adding request id to Symfony Request. 47576.3k3](/packages/qandidate-stack-request-id)[valga/fbns-react A PHP client for the FBNS built on top of ReactPHP 15751.3k19](/packages/valga-fbns-react)[linkeys/signed-url Enhanced signed URLs for Laravel, including attaching data, click limits and expiry. 2259.6k1](/packages/linkeys-signed-url) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)